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内 容 简 介 


本 书 采 用 模块 化 结构 ,以 大 量 案例 分 析 为 主线 ,介绍 了 Android 手机 操作 系统 的 开发 与 应 用 。 全 书 分 
为 Android 操作 系统 与 开发 环境 、UI 事件 控制 .Android 基本 界面 组 件 和 Android 高 级 界面 组 件 、 资 源 文 件 
使 用 ; Activity, Service 及 BroadcastReceiver 应 用 数据 存储 以 及 文件 读 写 、ContentProvider 应 用 、Android 
网 络 编程 .综合 案例 分 析 共 11 章 。 本 书 体系 结构 清晰 , 内容 围绕 Android 手机 操作 系统 开发 与 应 用 ,对 
Android 的 功能 按照 特性 进行 分 类 ,根据 由 浅 入 深 的 原则 ,以 教学 单元 搭配 步骤 讲解 ,每 个 章节 都 包含 精心 
设计 和 讲解 的 应 用 程序 开发 案例 ,使 书 的 内 容 在 广度 和 讲解 的 详细 程度 上 达到 最 佳 的 平衡 ,另外 ,本 书 着 
重 实际 操作 , 辅 以 适当 的 理论 讲解 ,让 读者 在 理解 Android 手机 技术 的 原理 的 同时 掌握 Android 重要 函数 
库 的 使 用 ,然后 再 通过 综合 案例 的 方式 将 所 学 的 开发 技术 融会 贯通 。 

本 书 适合 所 有 有 志 于 从 事 Android 手机 操作 系统 开发 并 有 一 定 Java 程序 设计 基础 的 人 员 参 考 使 用 ， 
也 可 以 作为 Android 手机 操作 系统 开发 的 培训 教材 。 
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随 着 我 国 改革 开放 的 进一步 深化 ,高 等 教育 也 得 到 了 快速 发 展 ,各 地 高 校 紧密 结合 
地 方 经 济 建 设 发 展 需要 ,科学 运用 市 场 调节 机 制 ,加 大 了 使 用 信息 科学 等 现代 科学 技术 
提升 改造 传统 学 科 专 业 的 投入 力度 ,通过 教育 改革 合理 调整 和 配置 了 教育 资源 ,优化 了 
传统 学 科 专 业 ,积极 为 地 方 经 济 建设 输送 人 才 , 为 我 国 经 济 社会 的 快速 .健康 和 可 持续 发 
展 以 及 高 等 教育 自身 的 改革 发 展 做 出 了 巨大 贡献 。 但 是 ,高 等 教育 质量 还 需要 进一步 提 
高 以 适应 经 济 社会 发 展 的 需要 ,不 少 高 校 的 专业 设置 和 结构 不 尽 合理 ,教师 队伍 整体 素 
质 亚 待 提高 ,人 才 培 养 模式 ,教学 内 容 和 方法 需要 进一步 转变 ,学 生 的 实践 能 力 和 创新 精 
ra m 。 

教育 部 一 直 十 分 重视 高 等 教育 质量 工作 。2007 年 1 月 ,教育 部 下 发 了 《关于 实施 高 等 
学 校本 科教 学 质量 与 教学 改革 工程 的 意见 》, 计 划 实 施 “ 高 等 学 校本 科教 学 质量 与 教学 改革 
工程 (简称 “质量 工程 ')”, 通 过 专业 结构 调整 ,课程 教材 建设 、 实 践 教学 改革 、 教 学 团队 建设 
等 多 项 内 容 , 进 一 步 深 化 高 等 学 校 教学 改革 ,提高 人 才 培 养 的 能 力 和 水 平 ,更 好 地 满足 经 济 
社会 发 展 对 高 素质 人 才 的 需要 。 在 贯彻 和 落实 教育 部 “质量 工程 "的 过 程 中 ,各 地 高 校 发 挥 
师资 力量 强 、 办 学 经 验 丰 富 .教学 资源 充裕 等 优势 ,对 其 特色 专业 及 特色 课程 ( 群 ) 加 以 规划 、 
整理 和 总 结 ,更 新 教学 内 容 、 改 革 课 程 体系 ,建设 了 一 大 批 内 容 新 ,体系 新 、 方 法 新 、 手 段 新 的 
特色 课程 。 在 此 基础 上 ,经 教育 部 相关 教学 指导 委员 会 专家 的 指导 和 建议 ,清华 大 学 出 版 社 
在 多 个 领域 精 选 各 高 校 的 特色 课程 ,分 别 规划 出 版 系列 教材 ,以 配合 “质量 工程 ”的 实施 , 满 
足 各 高 校 教学 质量 和 教学 改革 的 需要 。 

本 系列 教材 立足 于 计算 机 公共 课程 领域 ,以 公共 基础 课 为 主 、 专 业 基础 课 为 辅 ,横向 满 
足 高 校 多 层次 教学 的 需要 。 在 规划 过 程 中 体现 了 如 下 一 些 基本 原则 和 特点 。 

COD 面向 多 层次 .多 学 科 专业 ,强调 计算 机 在 各 专业 中 的 应 用 。 教 材 内 容 坚 持 基本 理论 
适度 ,反映 各 层次 对 基本 理论 和 原理 的 需求 ,同时 加 强 实践 和 应 用 环节 。 

(2) 反映 教学 需要 ,促进 教学 发 展 。 教 材 要 适应 多 样 化 的 教学 需要 ,正确 把 握 教学 内 容 
和 课程 体系 的 改革 方向 ,在 选择 教材 内 容 和 编写 体系 时 注意 体现 素质 教育 、 创 新 能 力 与 实践 
能 力 的 培养 ,为 学 生 的 知识 、 能 力 素质 协调 发 展 创造 条 件 。 

(3) 实施 精品 战略 ,突出 重点 ,保证 质量 。 规 划 教 材 把 重点 放 在 公共 基础 课 和 专业 基础 
课 的 教材 建设 上 ; 特别 注意 选择 并 安排 一 部 分 原来 基础 比较 好 的 优秀 教材 或 讲义 修订 再 
版 ,逐步 形成 精品 教材 ; 提倡 并 鼓励 编写 体现 教学 质量 和 教学 改革 成 果 的 教材 。 

(4) 主张 一 纲 多 本 ,合理 配套 。 基 础 课 和 专业 基础 课 教 材 配 套 , 同 一 门 课程 可 以 有 针对 
不 同 层次 、 面 向 不 同 专业 的 多 本 具有 各 自 内 容 特 点 的 教材 。 处 理 好 教材 统一 性 与 多 样 化 , 基 
本 教材 与 辅助 教材 .教学 参考 书 , 文 字 教 材 与 软件 教材 的 关系 ,实现 教材 系列 资源 配套 。 
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(5) 依靠 专家 ,择优 选用 。 在 制定 教材 规划 时 依靠 各 课程 专家 在 调查 研究 本 课程 教材 
建设 现状 的 基础 上 提出 规划 选 题 。 在 落实 主编 人 选 时 ,要 引入 竞争 机 制 , 通 过 申报 、 评 审 确 
定 主题 。 书 稿 完 成 后 要 认真 实行 审 稿 程序 ,确保 出 书 质量 。 

繁荣 教材 出 版 事业 ,提高 教材 质量 的 关键 是 教师 。 建 立 一 支 高 水 平 教材 编写 梯队 才能 
保证 教材 的 编写 质量 和 建设 力度 ,希望 有 志 于 教材 建设 的 教师 能 够 加 入 到 我 们 的 编写 队伍 
中 来 。 
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目前 Android 是 一 门 新 兴 技 术 , 无 论 是 相关 书籍 还 是 教育 体制 都 处 于 初级 阶段 ,因此 
Android 人 才 在 短期 之 内 将 会 呈现 供不应求 的 状态 。 从 长 期 来 看 , 随 着 各 种 移动 应 用 需求 
的 增加 ,手机 应 用 开发 商 对 Android 应 用 的 开发 力度 也 会 不 断 加 大 ,因此 , 随 着 安 卓 手机 用 
户 比例 的 增长 ,更 加 剧 了 市 场 对 有 关 Android 系统 开发 书籍 的 需求 。 

本 书 对 Android 的 功能 按照 特性 进行 分 类 ,根据 由 浅 入 深 的 原则 ,以 教学 单元 搭配 步骤 
讲解 ,每 个 章节 都 包含 精心 设计 和 讲解 的 应 用 程序 开发 案例 ,使 书 的 内 容 在 广度 和 深度 上 达 
到 最 佳 的 平衡 。 另 外 ,本 书 着 重 实际 操作 ,并 辅 以 适当 的 理论 讲解 ,让 读者 在 理解 Android 
手机 技术 的 原理 的 同时 掌握 Android 重要 函数 库 的 使 用 ,然后 再 通过 综合 案例 的 方式 将 所 
学 的 开发 技术 融会 贯通 。 

相对 其 他 教材 ,本 书 具有 如 下 特点 : 

(1) 遵循 一 个 基础 知识 点 对 应 一 个 实例 的 原则 : 将 实例 置 于 知识 点 之 前 ,然后 训 析 实 
例 , 阐 述 知识 点 。 

(2) 内 容 安排 更 加 合理 ,用 最 基础 的 实例 讲解 知识 点 ,让 初学 者 更 加 容易 接受 ,真正 做 
到 由 浅 入 深 。 

(3) 通过 对 基本 案例 和 综合 案例 循序 渐进 的 介绍 分 析 , 由 浅 入 深 地 完成 掌握 基本 操作 、 
基本 理论 到 完成 综合 案例 的 全 部 过 程 。 

本 书 可 作为 本 科 或 高 职高 专 软件 工程 计算 机 科学 与 技术 等 专业 的 教材 ,也 可 供 其 他 专 
业 学 生 和 从 事 Android 开发 与 应 用 的 有 关 技 术 人 员 参 考 。 课 程 标准 学 时 为 72 学 时 或 54 学 
时 ,在 教学 过 程 中 可 根据 具体 情况 选 学 本 书 内 容 。 

本 书 由 郑 耿 忠 主编 和 统 稿 , 其 中 第 1 一 6 章 由 郑 耿 忠 编写 ,第 7 一 11 章 由 庄 桂 东 编 写 , 书 
中 案例 由 庄 桂 东 录制 。 

本 书 在 编写 和 出 版 过 程 中 ,得 到 清华 大 学 出 版 社 编辑 的 指导 和 支持 ,在 此 对 他 们 的 辛勤 
劳动 和 无 私 奉献 表示 真挚 的 谢意 。 同 时 ,对 本 书 参考 文献 中 的 有 关 作 者 致 以 诚挚 的 感谢 。 

Android FERRE E ,应 用 广泛 ,技术 处 于 不 断 发 展 进步 中 ,限于 编者 自身 的 水 平和 
学 识 , 书 中 难免 存在 下 漏 之 处 , 诚 望 读者 不 音 赐 教 , 以 便 修 正 。 
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Android 操 作 系统 与 开发 环境 | 


Android 一 词 的 本 义 指 “ 机 器 人 ”, 同 时 也 是 Google 于 2007 年 11 月 5 日 宣布 的 基于 
Linux 平台 的 开源 手机 操作 系统 的 名 称 ,该 平台 由 操作 系统 .中 间 件 .用 户 界面 和 应 用 软件 
组 成 。Android 系统 已 经 成 为 全 球 应 用 并 具有 广泛 影响 力 的 手机 操作 系统 ,国内 对 Android 
开发 人 才 的 需求 也 在 迅速 增长 ,从 趋势 上 来 看 ,Android 软件 人 才 的 需求 会 越 来 越 大 。 

Android 2. 2 平台 的 模拟 器 更 加 稳定 , 故 本 书 所 带 的 Android 案例 也 是 在 Android 2. 2 
平台 上 调试 运行 的 。 本 章 将 重点 讲解 如 何 搭建 Android 开发 环境 ,创建 和 启动 手机 模拟 器 
以 及 学 习 使 用 Android 操作 系统 。 


(i.i Android 简介 
w 


智能 手机 软件 平台 有 Symbian, Windows Mobile, RIM BlackBerry, Android, iPhone, 
Palm,Brew,Java/J2ME, 2012 年 11 月 的 数据 显示 ,Android 占据 全 球 智能 手机 操作 系统 
市 场 76% 的 份额 ,在 中 国 市 场 的 占有 率 为 90% 。 接 下 来 将 重点 介绍 什么 是 Android 平台 。 


1.1.1 什么 是 Android 


Android 是 一 种 基于 Linux 的 自由 及 开放 源 代码 的 操作 系统 ,主要 使 用 于 移动 设备 ,如 
智能 手机 和 平板 电脑 ,由 Google 公司 和 开放 手机 联盟 领导 及 开发 。 它 包括 一 个 操作 系统 、 
中 间 件 和 一 些 重要 的 应 用 程序 。 它 采用 软件 堆 层 (Software Stack, 又 名 软件 释 层 ) 的 架构 ， 
主要 分 为 三 部 分 。 底 层 以 Linux 内 核 工 作为 基础 ,由 C 语言 开发 ,只 提供 基本 功能 ; 中 间 层 
包括 函数 库 Library 和 Dalvik 虚拟 机 ,用 C++ 语言 开发 。 最 上 层 是 各 种 应 用 软件 ,包括 通话 
程序 .短信 程序 等 ,我 们 要 做 的 ,就 是 以 Java 作为 编程 语言 编写 各 种 各 样 的 Android 应 用 软 
件 。 本 书 中 ,学习 Android 其 实 就 是 学 习 怎 么 开发 适用 于 在 Android 操作 系统 上 运行 的 
软件 。 

在 国内 ,Android 的 前 景 十 分 广阔 ,国内 很 多 的 厂商 和 运营 商 也 纷纷 加 入 了 Android 阵 
营 , 同 时 Android 应 用 的 范围 不 仅仅 在 手机 ,国内 一 些 广 家 也 陆续 推出 了 采用 Android 系统 
的 MID 产品 ,比较 著名 的 包括 由 Rockchip 和 蓝魔 推出 的 同时 具备 高 清 播 放 和 智能 系统 的 
音 悦 汇 W7, 可 以 预见 ,Android 也 将 会 被 广泛 应 用 在 国产 智能 上 网 设备 上 ,并 将 进一步 扩大 
Android 系统 的 应 用 范围 。 


(2^ Android 应 用 开发 从 入 门 到 精通 


1.1.2 Android 平台 的 架构 详解 


Android 平台 采用 一 种 被 称 为 软件 又 层 的 方式 进行 构建 ,就 像 一 个 多 层 蛋 糕 ,每 一 层 都 
有 自己 的 特性 和 用 途 。 这 种 软件 结构 使 得 层 与 层 之 间 相 互 分 离 , 明 确 各 层 的 分 工 。 这 种 分 
工 保证 了 层 与 层 之 间 的 低 耦 合 ,当下 层 的 层 内 或 层 下 发 生 改 变 时 ,上 层 应 用 程序 无 须 任何 改 
变 ,图 1.1 为 Android 系统 架构 。 
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图 1.1 Android 系统 架构 


由 图 1. 1 可 以 很 明显 地 看 出 ,Android 系统 架构 由 5 部 分 组 成 ,分 别 是 Applications( 应 
用 程序 层 )、Application Framework (W HH £& FF HE2 ) , Libraries (PR XE) , Android Runtime 
(Android 运行 时 ) Linux KernelCLinux 内 核 ) 。 下 面 分 别 对 这 5 部 分 进行 简单 介绍 。 


1. 应 用 程序 层 


Android 平台 装配 一 个 核心 应 用 程序 集合 ,这 些 程序 包括 电子 邮件 客户 端 \SMS 程序 、 
日 历 、 地 图 、 浏 览 器 、 联 系 人 和 其 他 设置 。 所 有 应 用 程序 都 是 用 Java 编程 语言 写 的 。 更 加 丰 
富 的 应 用 程序 有 待 我 们 去 开发 ,本 书 介绍 的 内 容 则 是 如 何 编写 Android 系统 上 的 应 用 程序 。 


2. 应 用 程序 框架 


通过 提供 开放 的 开发 平台 ,Android 使 开发 者 能 够 编写 极其 丰富 和 新 颖 的 应 用 程序 。 
开发 者 可 以 自由 地 利用 设备 硬件 优势 访问 位 置信 息 、 运 行 后 台 服 务 .设置 闹钟 .向 状态 栏 添 
加 通知 等 。 
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Android 应 用 程序 框架 提供 了 大 量 的 API 供 开发 者 使 用 ,关于 这 些 API 的 具体 功能 和 
用 法 则 是 本 书后 面 详细 介绍 的 内 容 。 

所 有 的 应 用 程序 其 实 是 一 组 服务 和 系统 ,包括 : 

。 视 图 (View) 一 一 丰富 的 、 可 扩展 的 视图 集合 ,可 用 于 构建 一 个 应 用 程序 ,包括 列表 、 
网 格 、 文 本 框 按 钮 ,甚至 是 内 嵌 的 网 页 浏览 器 。 

。 内 容 提 供 者 (Content Providers) 一 一 使 应 用 程序 能 访问 其 他 应 用 程序 (如 通讯 录 ) 
的 数据 ,或 共享 自己 的 数据 。 

。 资源 管理 器 (Resource Manager) 一 一 提供 访问 非 代码 资源 ,如 本 地 化 字符 串 、 图 形 


和 布局 文件 。 

。 通知 管理 器 (Notification Manager) 一 一 使 所 有 的 应 用 程序 能 够 在 状态 栏 显 示 自 定 
义 警告 。 

。 活动 管理 器 (Activity Manager) 一 一 管理 应 用 程序 生命 周期 ,提供 通用 的 导航 回 退 
功能 。 

3. 函数 库 


Android 包含 一 套 C/C++ 库 的 集合 , 供 Android 系统 的 各 个 组 件 使 用 。 一 般 来 说 ， 
Android 应 用 开发 者 不 直接 调用 这 套 C/C++ 库 集 ,而 是 通过 它 上 面 的 应 用 程序 框架 来 调用 
这 些 库 。 下 面 为 一 些 核心 库 : 

* 系统 C 库 一 一 标准 C 系统 库 (libc) 的 BSD 衍生 ,调整 为 基于 嵌入 式 Linux 设备 。 

。 媒体 库 一 一 基于 PacketVideo 的 OpenCORE。 这 些 库 支持 播放 和 录制 许多 流行 的 
音频 和 视频 格式 ,以 及 静态 图 像 文件 ,包括 MPEG4、H. 264, MP3, AAC, AMR, 
JPG、PNG 。 
界面 管理 一 一 管理 访问 显示 子 系统 和 无 颖 组合 多 个 应 用 程序 的 二 维和 三 维 图 形 层 。 
LibWebCore 一 一 新 式 的 Web 浏览 器 引擎 ,驱动 Android DU VE Ae RUP CT] Web 
视图 。 

。 SGIL 一 一 基本 的 2D 图 形 引擎 。 

* 3D 库 一 一 基于 OpenGL ES 1. 0 API 的 实现 。 库 使 用 硬件 3D 加 速 或 包含 高 度 优化 
的 3D 软件 光栅 。 

。 FreeType 一 一 位 图 和 矢量 字体 泻 染 。 

SQLite 一 一 所 有 应 用 程序 都 可 以 使 用 的 强大 而 轻 量 级 的 关系 数据 库 引 擎 。 


4. Android 运行 时 


Android 包含 一 个 核心 库 的 集合 ,提供 大 部 分 在 Java 编程 语言 核心 类 库 中 可 用 的 功 
能 。 每 一 个 Android 应 用 程序 是 Dalvik 虚拟 机 中 的 实例 ,运行 在 它们 自己 的 进程 中 。 
Dalvik 虚拟 机 设计 成 在 一 个 设备 可 以 高 效 地 运行 多 个 虚拟 机 。Dalvik 虚拟 机 可 执行 的 文 
件 格式 是 . dex,. dex 格式 是 专 为 Dalvik 设计 的 一 种 压缩 格式 ,适合 内 存 和 处 理 器 速度 有 限 
的 系统 。 

大 多 数 虚拟 机 包括 JVM 都 是 基于 栈 的 ,而 Dalvik 虚拟 机 则 是 基于 寄存 器 的 。 两 种 架 
构 各 有 优 劣 ,一 般 而 言 , 基 于 栈 的 机 器 需要 更 多 指令 ,而 基于 寄存 器 的 机 器 指令 更 大 。dx 是 
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一 套 工具 ,可 以 将 Java . class 转换 成 . dex 格式 。 一 个 . dex 文件 通常 会 包括 多 个 . class X 
件 。 由 于 . dex 有 时 必须 进行 最 佳 化 ,会 使 文件 大 小 增加 1 一 4 倍 , 并 以 . odex 结尾 。 
Dalvik 虚拟 机 依赖 于 Linux 内 核 提供 基本 功能 ,如 线程 和 底层 内 存 管 理 。 


5. Linux 内 核 


Android 系统 建立 在 Linux 2. 6 之 上 ,提供 核心 系统 服务 ,例如 ,安全 \ 内 存 管理 .进程 
管理 .网 络 堆栈 、 驱 动 模型 。 除 此 之 外 ,Linux Kernel 也 作为 硬件 和 软件 之 间 的 抽象 层 , 它 隐 
藏 具体 硬件 细节 而 为 上 层 提 供 统 一 的 服务 。 

如 果 只 是 做 应 用 开发 ,就 不 需要 深入 了 解 Linux Kernel J£. 


(.2 搭建 Android 开发 环境 


在 搭建 Android 开发 环境 之 前 ,还 需要 JDK( 仅 有 JRE RI), Eclipse IDE. iij fff JDK 
安装 、 环 境 变量 设置 之 类 的 知识 不 在 本 书 中 进行 讲解 , 若 读者 尚 不 明白 这 些 操 作 ,建议 先 掌 
担 这 些 知 识 后 再 开始 搭建 Android 开发 环境 。 


1.2.1 如何 下 载 和 安装 ADT 插件 


在 企业 开发 中 ,很 多 程序 员 使 用 Eclipse IDE 作为 应 用 的 开发 环境 , Android 推荐 使 用 
Eclipse 来 开发 Android 应 用 。 为 了 使 得 Android 应 用 的 创建 ,运行 和 调试 更 加 方便 快捷 ， 
Android 的 开发 团队 专门 针对 Eclipse IDE 定制 了 一 个 插件 : Android Development Tools 
(ADT). 

ADT 插件 的 安装 有 在 线 安装 和 离线 安装 两 种 方式 。 下 面 介绍 离线 安装 ADT 插件 的 
步骤 ,图 1.2 为 ADT 插件 下 载 链接 。 

(D 登录 http://developer. android. com/sdk/installing/installing-adt. html # tmgr 站 
点 ,下 载 ADT 插件 的 最 新 版 本 。 

@ 将 页 面 往 下 拉 , 可 以 看 到 如 图 1. 2 所 示 的 表格 , 单 击 ADT-22. 3. 0. zip 链接 直接 下 载 


ADT 插件 到 本 地 。 
ADT-22.3.0.zip 14493723 bytes 0189080b23dfa0f866adafaaafcc34ab 


图 1.2 ADT 插件 下 载 链接 


© 启动 Eclipse, Æ Eclipse 主 菜 单 中 选择 Help Install New Software 命令 ,在 出 现 的 
如 图 1. 3 所 示 的 对 话 框 中 , 单 击 Add 按钮 。 

© 在 弹出 的 如 图 1. 4 所 示 的 对 话 框 的 Name 文本 框 中 输入 ADT, 然 后 单 击 Archive f 
钮 ,浏览 和 选择 已 经 下 载 的 ADT 插件 的 压缩 文件 。 

© 单 击 OK 按钮 ,返回 如 图 1. 5 所 示 的 可 用 软件 的 视图 ,选中 Developer Tools 复 选 框 
( 即 ADT 插件 ) ,然后 单 击 Next 按钮 ,Eclipse 弹出 一 个 对 话 框 ,该 对 话 框 会 提示 用 户 所 有 将 
要 安装 的 插件 详细 清单 , 单 击 该 对 话 框 的 Next 按钮 。 
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Available Software 
Select a site or enter the location of a site. 






































Work with MEE - [ade 
] Find more software by working with the "Available Software Sites" preferences. 
type fier text | 
Name Version 
G) There is no site selected. 
ITE 
Details 
[V] Show only the latest versions of available software [F Hide items that are already installed 
Group items by category What is already installed? 
Show only software applicable to target environment 


|| [VI Contact all update sites during install to find required software 
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图 1.3 选择 插件 安装 














1.4 浏览 ADT 插件 


(6 在 Eclipse 弹出 的 如 图 1.6 所 示 的 窗口 中 选择 接受 协议 条 款 , 单 击 Finish 按钮 ， 
Eclipse 开始 安装 ADT 插件 。 

ADT 插件 的 在 线 安装 步骤 跟 离线 安装 的 步骤 基本 一 致 ,区 别 是 在 第 4 步 时 ,在 弹出 的 
对 话 框 中 不 再 选择 已 经 下 载 好 的 ADT 插件 ,而 是 在 Location 文本 框 中 直接 输入 “https:// 
dl-ssl. google. com/android/eclipse/”, 如 图 1. 7 所 示 , 然 后 单 击 OK 按钮 ,之 后 的 步骤 与 离 
线 安装 完全 一 致 。 


1.2.2 如何 下 载 和 安装 Android SDK 


Android SDK 包含 了 开发 Android 应 用 所 依赖 的 jar 文件 .运行 环境 及 相关 工具 ,安装 
Android SDK 请 按 下 面 步骤 进行 : 


6 
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Available Software 
Check the items that you wish to install. 
Work with: ADT - jarffile/C;/Users/Administrator/Desktop/ADT-22.3.0.zip!/ - Add 
Find more software by working with the "Available Software Sites" preferences. 
type filter text 
Name Version 
> (|i Developer Tools 
» E] 000 NDK Plugins 
[aseetan] 5 iers esed 
Details 
[V] Show only the latest versions of available software [V] Hide items that are already installed 
[V] Group items by category What is already installed? 
[E] Show only software applicable to target environment 
find required softwarel 
@ NIE [N— 

















图 1.5 选中 ADT 插件 











Review Licenses 
Licenses must be reviewed and accepted before the software can be installed. 

licenses: License text: 
b Apache License Apache License ^ 
> Note: jcommon-10.12jjar is under the BSD license rather than th Version 2.0, January 2004 国 
D Note: loml2-2.3.0jar is under the BSD license rather than the EPI| http://www.apache.org/licenses/ 


TERMS AND CONDITIONS FOR USE, 
REPRODUCTION, AND DISTRIBUTION 


1. Definitions. 
"License" shall mean the terms and conditions 


for use. reproduction, 
and distribution as defined by Sections 1 


through 9 cf this document. 
“Licensor” shall mean the copyright owner or 
RRSELE entity authorized by 














9 1 accept the terms of the agreements 
© I do not accept the terms of the license agreements 








| 











e "| 























1.6 同意 条 款 
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adipe 2 

















Name: ADT Local... 
Location: https;//dl-ss.google.com/android/eciipse/ Archive... 
直接 填 入 该 地 址 
9 























图 1.7 离线 安装 ADT 


(D Android SDK 的 下 载 地 址 是 http://developer. android. com/sdk/index. html, $f 
入 该 地 址 ,将 页 面 往 下 拉 , 单 击 DOWNLOAD FOR OTHER PLATFORMS 链接 ,继续 往 下 
拖 动 页 面 ,可 看 到 SDK 的 下 载 链接 ,选择 所 需要 的 版 本 进行 下 载 ,一 般 下 载 解 压 版 ,如 图 1. 8 
所 示 。 


SDK Tools Only 单 击 所 要 下 翰 的 版 本 镑 按 
Platform Package Size MD5 Checksum 
Windows android-sdk 122 3-windows.zip 108847452 O9f0fe8cB884d6ace2b298fee203c52dc 
32&64- bytes 
ur installer. r22.3-windows.exe B8845794 ad50c4dd9e23cee65a1ed740ff3345fa 
(Recommended) bytes 
MacOSX  android-sdk r22.3-macosx zip 14893875 ecde88ca1105955826697848fcb4a9e7 
32&64- bytes 
bit 
Linux android-sdk 122.3-linux tgz 100968558 6ae581a906d6420ad67176dff25a31cc 
32& 64- bytes 
bit 
图 1.8 下 载 SDK 


© 将 下 载 完 成 后 得 到 的 android-sdk_r22. 3-windows. zip 文件 解压 缩 到 任意 路 径 下 , 例 
如 “D:\” 根 目录 。 解 压缩 后 得 到 一 个 名 为 android-sdk-windows 的 文件 夹 ,该 文件 夹 包 含 以 
下 文件 结构 。 

add-ons: 该 目录 下 存放 额外 的 附加 软件 , 刚 解压 缩 时 该 目录 为 空 。 

如 platforms: 该 目录 下 存放 不 同 版 本 的 Android 版 本 , 刚 解 压缩 时 该 目录 为 空 。 

tools; 该 目录 下 存放 了 许多 Android 开发 .调试 的 工具 。 

名 AVD Manager. exe; AVD(Android 虚拟 设备 ) 管 理 器 ,通过 该 工具 可 以 管理 AVD. 

名 SDK Manager. exe; Android SDK 管理 器 ,通过 该 工具 可 以 管理 Android SDK, 

© 单 击 SDK Manager. exe, 弹 出 如 图 1.9 所 示 窗 口 ,在 窗口 中 选中 需要 安装 的 工具 ,其 
中 Android 平台 工具 是 必 选 项 ,读者 喜爱 下 载 哪个 版 本 的 SDK, 则 选中 其 版 本 的 SDK ,可 一 
次 性 选择 所 有 版 本 ,也 可 在 以 后 需要 的 时 候 再 对 特定 版 本 进行 下 载 。 选 中 后 单 击 Install 9 
packages 按钮 进行 安装 。 

CD 在 弹出 的 如 图 1. 10 所 示 的 对 话 框 中 , 列 出 了 将 要 安装 的 Android 工具 包 , 选 择 接 受 
所 有 许可 内 容 , 然 后 单 击 Install Sz £l. Android SDK 管理 器 就 开始 下 载 并 安装 读者 所 选 的 
工具 包 了 ,如 图 1. 11 所 示 。 等 待 一 段 时 间 即 可 完成 ,但 该 段 时 间 的 长 短 取决 于 读者 的 网 络 
状态 及 所 选中 的 工具 包 数 量 , 有 时 候 甚 至 会 花费 一 两 个 小 时 。 
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入 Android SDK Tools 
Android SDK Platform-tools 
E 4^ Android SDK Build-tools 
E] £ Android SDK Build-tools 
回 Android SDK Build-tools 
转产 Android SDK Build-tools 
E] fF Android SDK Build-tools 
E] f Android SDK Build-tools 


223 [f Installed 
1901 |.) Not installed. 
1962 | | Not installed 
1901 (7 Not installed 
19 Ù Notinstalled 
1811 OD Not installed 
1&1 (7 Not installed 
180.1 ( Not installed 
A7 (7 Not installed 


选中 项 目 后 单 击 该 按钮 





Show. [V|Updetes/New [Installed C Obsolete Select New or Updates 


Sort by: @ API level © Repository 


Deselect All 

















19 安装 所 需 工具 


v Android SDK License 
«v^ Android SDK Platform-tools, revis 
v Documentation for Android SDK, 
«v SDK Platform Android 4.4.2, API 1| 
«v Samples for SDK API 19, revision 
f ARM EABI v7a System Image, And 
«vf Intel x86 Atom System Image, And 
wv Google APIs (x86 System Image), 
we Google APIs, Android API 19, revi 
«vf Sources for Android SDK, API 19, 











四 Something depends on this package 








Package Description & License 


Packages 

~ Android SDK Platform-tools, revision 19.0.1 

- Documentation for Android SDK, API 19, revision 2 

- SDK Platform Android 4.4.2, API 19, revision 2 

- Samples for SDK API 19, revision 3 

- ARM EABI v7a System Image, Andrcid API 19, revision 2 

- Intel x86 Atom System Image, Android API 19, revision 2 

- Gcogle APIs (x86 System Image), Android AP 19, revision 2 
- Google APIs, Android API 19, revision 3 

~ Sources for Android SDK, API 19, revision 2 


License 
Terms and Conditions 


BRAEM 
This is the Android Software Development Kit License 
Accept ^ Rejet Copy to clipboard | Print 
FETERE 





图 1.10 将 要 安装 的 工具 包 
C) 安装 完成 后 , 回 到 Android SOK 文件 夹 界面 ,可 以 看 到 该 目录 下 增加 了 如 下 几 个 文 


件 夹 。 


docs; 该 文件 夹 下 存放 了 Android SDK 开发 文件 和 API 文档 等 。 
æ platform-tools: 该 文件 夹 下 存放 了 Android 平台 相关 工具 。 
samples; 该 文件 夹 下 存放 了 不 同 Android 平台 的 示例 程序 。 
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Packages Tools 
SDK Path: FAandroid-sck-windows 








mddur aa m 


Fetching URL: http;//dl-ssl.google.com/android/repository/sys-img/x86/addon-x86.xml 3 

Validate XML: http;//dl-ssl.google.com/android/repository/sys-img/x86/addon-x86.xml 

|| ParseXML: http;//dl-ssL.google.com/android/repository/sys-img/x85/addon-x86.xml 
Fcund Google APIs (x86 System Image), Android API 19, revision 2 

Done loading packages. 

Preparing to install archives 

Downloading Android SDK Platform-tools, revision 19.0.1 

Installing Android SDK Platform-tools, revision 19.0.1 

Stopping ADE server failed (code -1). 

Installed Android SDK Platform-tcols, revision 19.0.1 

Downloading Documentation for Android SDK, API 19, revision 2 
































Pa 





Downloading Documentation for Android SDK, API 19, revision 2 (78%, 7627 KiB/s, 4 seconds left) 


























ER 二 


Show: [VlUpdetes/New 园 Installed [F Obsolete Select New or Updates 
Sort by: G API level © Repository Deselect All Delete 1 package... 
— OM] 

Om 


Downloading Documentation for Android SDK, API 19, revision 2 (78%, 7627 KiB/s, 4 seconds left) 




















图 1.11 在 线 安 装 Android 工具 包 


© 启动 Eclipse, X Eclipse 设置 Android SDK 的 路 径 ,选择 Eclipse 主 菜 单 Window- 
Preferences 菜单 项 ,在 打开 的 如 图 1. 12 所 示 的 视图 的 左 侧 单 击 Android 选项 ,在 右 侧 的 
SDK Location 文本 框 中 输入 Android SDK 所 在 位 置 , 单 击 OK 按钮 ,完成 Android SDK 的 
路 径 设 置 。 
EI E] 


b General 
> Android 


DAR SDK Location: DAandroid-sdk-windows 


b Code Recommenders Note: The list of SDK Targets below is only reloaded once you hit 'Apply' or 'OK. 
































> ie Target Name Vendor Platform API 
» Jova Android 2.2 Android Open Source Project 22 8 
» Maven Google APIs Google Inc. 22 8 
b Mylyn Android 4.3 Android Open Source Project 43 18 
> Run/Debug 
b Team 

Validation 
» WindowBuilder 
b XML 

Standard Android platform 4.3 









































图 1.12 设置 SDK 路 径 


经 过 上 面 所 介绍 的 过 程 , 接 下 来 就 可 以 在 Eclipse 中 开发 Android 应 用 了 。 


Q Android 应 用 开发 从 入 门 到 精通 


(3 使 用 Android 模拟 器 


前 面 主要 介绍 了 如 何 搭建 Android 开发 环境 ,但 我 们 开发 后 的 程序 将 运行 于 Android 
操作 系统 ,不 再 像 以 前 开发 Windows 软件 一 样 运行 于 Windows 平台。 当然 ,我 们 不 能 要 求 
每 个 开发 者 都 去 买 一 台 搭建 了 Android 平台 的 手机 然后 才 开 始 学 习 , 此 时 可 以 借助 
Android 提供 的 “虚拟 设备 ”工具 来 模拟 Android 手机 。 除 此 之 外 ,Android SDK 还 提供 了 
大 量 工具 来 帮助 我 们 进行 开发 .调试 。 


1.3.1 创建 .删除 和 浏览 AVD 


AVD, 即 Android Virtual DeviceCAndroid 虚拟 设备 ) , 当 开 发 者 没有 Android 手机 时 ， 
则 可 以 将 编写 好 的 Android 应 用 安装 在 Android SDK 提供 的 AVD 上 运行 。 下 面 分 别 介绍 
两 种 管理 AVD 的 方式 。 


1. 在 图 形 界面 下 管理 AVD 


在 图 形 界面 下 管理 AVD 比较 简单 ,可 以 借助 AVD 管理 器 来 完成 ,完全 在 图 形 用 户 界 
面 下 操作 ,比较 适合 新 上 手 的 读者 。 

(D 双击 Android SDK 安装 目录 下 的 AVD Manager. exe 文件 或 者 单 击 如 图 1. 13 所 示 
的 Eclipse 工具 栏 上 的 Android Virtual Device Manager 按钮 ,启动 AVD 管理 器 。 





1.13 Eclipser 工具 栏 上 的 AVD Manager 按钮 


© 在 弹出 的 如 图 1.14 所 示 的 窗口 中 , 列 出 了 可 用 的 Android 模拟 器 , 单 击 窗口 右边 的 
New 按钮 ,以 此 新 建 AVD. 
























List of existing Android Virtual Devices located at C:\Users\Administrator\.android\avd 





AVD Name Target Name. Platform API Level — CPU/ABI 
E No AVD available - SY 


3 山本 用 的 Am 




















Y A valid Android Virtual Device. FÌ) A repairable Android Virtual Device. 
X An Android Virtual Device that failed to load. Click 'Details' to see the error. 





























图 1.14 查看 所 有 可 用 的 AVD 设备 
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© 在 弹出 的 如 图 1. 15 所 示 的 对 话 框 中 ,填写 AVD 设备 的 名 称 、 选 择 AVD 设备 的 分 
辩 率 以 及 运行 的 Android 版 本 、 填 写 虚 拟 SD 卡 的 大 小 ,然后 单 击 该 对 话 框 下 面 的 OK f 
钮 ,管理 器 则 开始 创建 AVD 设备 ,开发 者 只 需 稍 作 等 待 即 可 。 


© Create new Android Virtual Device (A\ - 
-一 一 一 一 一 Wr 


AVD2.2 






























































3.2* HVGA slider (ADP1) (320 x 480: mdpi) ~ 
Android 2.2 - API Level 8 - 
| CPU/ABI: | ARM (armeabi) - 
Keyboard: [V] Hardware keyboard present 
| skin: V] Display a skin with hardware controls 
Front Camera: [None * 
Back Camera: — (None. = 
| Memory Options: | RAM: 512 VM Heap: 16 
Internal Storage: “300 ES 
SD Card: 
exeo Ed ee Size: 200 
© File: | (Browse... | 


Emulation Options: | 四 Snapshot = IF]Use Host GPU 


C Override the existing AVD with the same name 





























[muc rnm 


1.15 创建 AVD 设 备 


创建 完成 后 ,管理 器 返回 如 图 1. 16 所 示 的 窗口 ,该 管理 器 将 会 列 出 当前 所 有 可 用 的 
AVD 设备 ,读者 可 以 看 到 我 们 刚刚 创建 的 AVD 设备 。 如 果 开 发 者 想 删 除 某 个 AVD 设备 ， 
只 要 在 如 图 1. 16 所 示 的 窗口 中 选择 指定 AVD 设备 ,然后 单 击 右边 的 Delete 按钮 即 可 。 如 
果 开 发 者 想 要 浏览 某 个 AVD 设备 ,只 要 在 如 图 1. 16 所 示 的 窗口 中 选择 指定 AVD 设备 , 然 
后 单 击 右边 的 Details 按钮 , 即 会 弹出 一 个 AVD 详情 窗口 , 供 开 发 者 查看 。 

AVD 设备 创建 成 功 后 ,开发 者 即 可 运行 该 AVD 了 。 借 助 如 图 1.16 所 示 的 AVD 管理 
器 来 运行 AVD 设备 非常 简单 : 首先 .在 如 图 1. 16 所 示 的 窗口 左边 选中 所 要 启动 的 AVD 
设备 ; 其 次 ,在 该 窗口 右边 单 击 Start 按钮 ,弹出 如 图 1. 17 所 示 的 窗口 ; 最 后 ,在 图 1.17 所 
示 窗 口中 , 单 击 Launch 按钮 ,模拟 器 即 开始 启动 ,启动 过 程 如 图 1. 18 所 示 , 启 动 完 毕 后 的 
模拟 器 如 图 1. 19 所 示 。 
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Í B Android Virtual Device Manager V." RR [ES] 














Android Virtual Devices | Device Definitions 








List of existing Android Virtual Devices located at CAUsers Administrator androidvavd 

















AVD Name Target Name Platform API Level ^ CPU/ABI En 
WAvD22 Android 22 22 8 ARM (armeab) | Em | 
| | Delete... 

Repair 









































© Launch Options 7 — m.s) 





| Skini 320x480 
| Density: Medium (160) 


E Scale display to real size 


E Wipe user data 


Cl Save to snapshot 





Launch from snapshot 


Carca 








F- 
里 
Ed 


图 1.17 即将 启动 


2. 在 命令 行 管 理 AVD 


Details... 
Start.. 
Refresh 
f A valid Android Virtual Device. A repairable Android Virtual Device. 
X An Android Virtual Device that failed to load. Click "Details' to see the error. 
图 1.16 查看 刚 创 建 的 AVD 设备 
iB 5554:AvD22 esl =  j 


- —À 





图 1.18 模拟 器 启动 过 程 


在 命令 行 中 管理 AVD, 首 先 要 配置 好 Android 环境 变量 ,具体 方法 和 配置 Java 环境 变 


一 样 。 以 Windows XP 平台 为 例 : 右 击 “我 的 电脑 ”, 在 弹出 的 快捷 菜单 中 选择 “属性 ” 命 
令 , 在 “高 级 ”选项 卡 中 选择 “环境 变量 ”. 然 后 新 建 一 个 ANDROID_HOME, 将 本 机 中 的 
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B 5554:AvD22 








图 1.19 模拟 器 启动 完毕 


SDK 全 路 径 粘贴 进去 ,然后 在 Path 下 面 加 入 *.; "ANDROID HOME X /platform-tools; 
%ANDROID_HOME%/tools" 即 可 。 这 里 要 注意 标点 符号 要 用 英文 ,同时 不 要 忘 了 最 前 面 
的 *.”。 在 配置 好 环境 变量 后 ,就 可 以 通过 命令 行 管理 AVD 了。 首先, 如果 直 接 在 命令 行 
执行 android 命令 将 会 启动 Android SDK 管理 器 。 其 他 命令 如 下 : 

g android list 一 一 列 出 计算 机 上 所 有 已 经 安装 的 Android 版 本 和 AVD 设备 。 

æ android list avd 一 一 列 出 计算 机 上 所 有 已 经 安装 的 AVD 设备 。 

Zt android list target 一 一 列 出 计算 机 上 所 有 已 经 安装 的 Android 版 本 。 

4' android create avd 一 一 创建 一 个 AVD 设备 。 

Zt android move avd 一 一 移动 或 重 命名 一 个 AVD 设备 。 

android delete avd 一 一 删除 一 个 AVD 设备 。 

android update avd 一 一 升级 一 个 AVD 设备 使 之 符合 新 的 SDK 环境 。 

æ android create project 一 一 创建 一 个 新 的 Android 项 目 。 

Zt android update project 一 一 更 新 一 个 已 有 的 Android 项 目 。 

Zt android create test-project 一 一 创建 一 个 新 的 Android 测试 项 目 。 

Zt android update test-project 一 一 更 新 一 个 已 有 的 Android 测试 项 目 。 

要 创建 一 个 AVD, 使 用 android create avd 命令 ,给 出 几 个 参数 : 要 创建 的 AVD 的 名 
称 以 及 要 创建 的 AVD 搭载 的 Android 版 本 。 当 然 还 可 以 指定 其 他 参数 ,例如 ,AVD 设备 
的 保存 位 置 、 虚 拟 SD 卡 的 大 小 、 模 拟 器 的 皮肤 。 例 如 ,android create avd -n < avd 名 称 > -t 
< Android 版 本 > -p < AVD 设备 保存 位 置 > -s < 选择 AVD 皮肤 >。 

在 上 面 创建 AVD 命令 中 ,只 有 AVD 名 称 以 及 Android 版 本 两 个 参数 是 必 填 的 ,而 如 
果 不 设置 AVD 设备 的 保存 位 置 , 则 默认 保存 在 "%ANDROID_HOME/. avd% ?路 径 下 。 
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例如 ,创建 一 个 名 为 AVD2. 2 ,搭载 的 安 卓 版 本 为 Android 2. 2 的 模拟 器 设备 ,由 于 
Android 2. 2 的 代号 为 “8”, 所 以 输入 如 下 命令 即 可 : 


android create avd- n AVD2.2 - t android- 8 


执行 上 面 的 命令 ,系统 会 提醒 用 户 是 否 需 要 定制 AVD 的 硬件 ,开发 者 可 以 选择 yes 或 
no。 如 果 选 择 no, 即 可 直接 开始 创建 AVD 设备 ; 如 果 选 择 yes, 即 可 开始 定制 AVD 硬件 的 
各 种 选项 ,定制 完成 后 系统 开始 创建 AVD 设备 。 


1.3.2 使 用 Android 模拟 器 


Android 模拟 器 就 是 一 台 运行 在 计算 机 上 的 “虚拟 设备 ”, 实 际 上 前 面 我 们 已 经 使 用 过 
Android 模拟 器 了 ,在 AVD 管理 器 中 选中 指定 AVD 设备 ,然后 单 击 Start 按钮 就 是 启动 模 
拟 器 来 运行 Android 系统 。 

在 Android SDK 安装 目录 的 tools 子 目 录 下 有 一 个 emuLator. exe 文件 , 它 就 是 
Android 模拟 器 。 这 个 模拟 器 做 得 十 分 出 色 ,几乎 可 以 模拟 真实 手机 的 绝 大 部 分 功能 ,后 面 
会 陆续 看 到 一 一 当然 它 只 是 模拟 ,不 要 指望 用 模拟 器 与 你 现实 中 的 朋友 ”* 煲 电话 粥 ”。 

使 用 emulator. exe 启动 模拟 器 有 两 种 用 法 : 

æ emulator -avd < AVD 名 称 > 

zt emulator -data 镜像 文件 名 称 

第 一 种 用 法 是 运行 指定 的 AVD 设备 ,例如 如 下 命令 : 


emulator - avd AVD2.2 // 运 行 名 为 AVD2.2 的 AvD 设备 
第 二 种 用 法 是 直接 使 用 指定 镜像 文件 来 运行 AVD, 例 如 如 下 命令 ; 
emulator - data myfile //VJ myfile 作为 镜像 文件 来 运行 AVD 设备 


(1.4 开发 第 一 个 Android 应 用 
usb? 


前 面 已 经 介绍 了 Android 系统 的 一 些 基本 知识 以 及 如 何 搭建 开发 Android 应 用 的 环 
境 , 包 括 Android SDK 的 安装 和 ADT 插件 安装 ,如 何 创建 和 使 用 模拟 器 。 接 下 来 ,就 可 以 
开始 进入 第 一 个 Android 应 用 的 开发 了 。 其 实 , 开 发 Android 应 用 十 分 简单 ,Android 编程 
就 是 面向 应 用 程序 框架 API 编程 ,只 要 学 习 了 Android 的 一 般 开 发 流程 ,就 可 以 轻松 开发 
具备 丰富 功能 的 应 用 了 。 


1.4.1 在 Eclipse 中 开发 第 一 个 Android 应 用 


Java 是 Android 官方 推荐 的 用 于 开发 Android 应 用 的 编程 语言 ,而 Eclipse 是 流行 的 编 
写 Java 代码 的 开发 工具 ,也 是 最 常用 的 软件 开发 工具 , 它 可 以 很 好 地 提高 开发 者 的 开发 效 
率 。 使 用 Eclipse JF Android 应 用 大 致 需要 如 下 三 步 : 

(D 创建 一 个 Android 项 目 。 

© 在 XML 布局 文件 中 定义 应 用 程序 的 用 户 界面 。 

O 在 Java 代码 中 编写 业务 实现 。 
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上 面 三 个 步骤 是 最 基本 的 归纳 ,下 面 以 一 个 HelloWorld 级 别 的 应 用 来 介绍 开发 
Android 应 用 的 一 般 流程 。 详 细 步 又 如 下 : 
(D 在 Eclipse 主 菜单 单 击 File>New>Other 菜单 项 ,弹出 如 图 1. 20 所 示 的 窗口 ,在 出 
现 的 列表 中 展开 Android 目录 ,选择 Android Application Project, 


Em ENS x) 






Create an Android Application Project 











3 Android Project from Existing Code 
GS Android Sample Project 

JẸ Android Test Project 

[di Android XML File 

[È Android XML Layout File 























Ds 


图 1.20 新 建 Android 项 目 
© fil; Next 按钮 ,出 现 如 图 1. 21 所 示 的 对 话 框 ,在 该 对 话 框 中 填写 应 用 名 称 \ 工 程 名 
PK RUA ,选择 Android 版 本 号 ,然后 一 直 单 击 Next 按钮 ,最 后 单 击 Finish 按钮 。 
-— — — —————— —— — 2 leai 


New Android Application 
| Creates a new Android Application 











Application Name:9 第 一 个 Android 应 用 
Project Name:® FirstApp 
Package Name:9 cn.edu.hstc.firstapp 











Minimum Required SDK:e| [API 8: Android 2.2 (Froyo) 了 | 
Target SDK:© [API 8: Andreid 22 (Froyo): z 

Compile Who A0 BA nenid adim 

Theme:6 [Á 


























Q Choose the base theme to use for the application 








@ ER 











1.21 填写 相关 项 


Q Android 应 用 开发 从 入 门 到 精通 


© 单 击 Finish 按钮 , 即 成 功 创建 了 一 个 Android MA. 创建 完成 后 可 以 看 到 如 
图 1. 22 所 示 的 项 目 结构 。 


4 GÀ FirstApp 
asr 
4 Bi enedu.hste firstapp 
4 器 gen [Generated lava Files] 
4 iB cn.edu.hstcfirstapp 
b 国 BuildConfigjava 
D» D Rjava 
4 mÀ Android 2.2 
b @ androidjar - DAeclipseVadt-bundle-windows 
b BÀ Android Private Libraries 
» gà Android Dependencies 
D assets 
» Q5 bin 
b B» libs 
4 5 res 
b @ drawable-hdpi 
© drewable-ldpi 
b © drawable-mdpi 
b & drawable-xhdpi 
b (&& drawable-xhdpi 
4 © layout 
[B] activity mainxml 
b C» menu 
b © values 
b G9 values-swG00dp 
b © values-sw720dp-land 
id] AndroidManifest.xml 
Iii ic launcher-web.png 
国 proguard-projectbdt 
国 project properties 


1.22 Android 项 目 结构 


© 可 以 看 到 ,在 如 图 1. 22 所 示 的 Android 项 目 结构 中 ,layout 目录 下 有 一 个 activity_ 
main. xml 文件 ,该 文件 用 于 定义 Android 应 用 的 用 户 界面 。 双 击 该 文件 ,将 看 到 该 文件 中 
的 代码 ,对 代码 稍 作 修改 ,修改 后 的 文件 内 容 如 下 所 示 。 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
xmlns: tools = "http: //schemas. android. com/tools" 
android:layout width = "match parent" 
android:layout height - "match parent" 
android:orientation = "vertical" 
tools:context = ". MainActivity" > 


< TextView 
android:id- "(2 * id/txt title" 
android:layout width- "fill parent" 
android:layout height - "wrap content" 
android:gravity = "center horizontal" 
android:text = "(Qstring/hello world" /> 


« EditText 
android:id- "(2 + id/edt show" 
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android:layout width- "fill parent" 
android:layout height - "wrap content" /» 


« Button 
android:id- "@ + id/btn confirm" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:text = "(Qstring/confirm" /> 


«/LinearLayout > 
代码 文件 : codes\01\1.4\FirstApp\res\layout\activity main. xml 

这 里 对 上 面 的 XML 文件 作 一 个 简单 的 介绍 。 

如 LinearLayout: xml 文档 的 根 元 素 , 代 表 了 一 个 线性 布局 ,设置 orientation 属性 为 

vertical ,将 该 界面 布局 里 包含 的 UI 控件 按 顺 序 从 上 至 下 排放 。 

如 TextView: 代表 了 一 个 文本 框 , 用 于 显示 文本 ,有 点 类 似 于 HTML 中 的 label 标签 。 

layout. width 属性 与 layout_height 属性 设置 为 wrap_content, 指 定 该 控件 的 宽度 与 
高 度 都 是 “包含 内 容 ”, 取 决 于 它 所 包 庄 的 内 容 的 大 小 ,只 要 宽度 与 高 度 能 包 庄 所 含 内 
容 即 可 。text 属性 则 设置 了 该 控件 上 所 显示 的 文字 。id 属性 指定 了 该 控件 的 唯一 标 
识 , 在 Java 程序 中 可 通过 findViewByld("id") 来 获取 指定 的 Android 界面 组 件 。 

名 EditText: 代表 了 一 个 文本 编辑 框 ,供用 户 输入 文本 ,有 点 类 似 于 HTML 中 的 text 
标签 。layout_width 属性 设置 为 fill_parent, 指 定 该 控件 的 宽度 为 占 满 了 父 容器 所 具 
有 的 宽度 ,这 里 为 屏幕 宽度 。 其 他 属性 参考 TextView 控件 。 

zr Button; 代表 了 一 个 普通 按钮 ,供用 户 单 击 操作 ,有 点 类 似 于 HTML 中 的 button 标 
符 。 该 控件 所 设置 的 layout. width,layout height,text,id 等 通用 属性 所 起 作用 参考 
上 面 三 个 组 件 , 此 处 不 再 著述 。 

在 这 里 有 一 个 小 小 的 建议 ,就 是 当 需 要 为 一 个 控件 指定 id 属性 时 ,将 该 属性 写 在 所 有 
属性 的 后 面 , 即 放 在 该 组 件 标 签 元 素 的 最 后 一 行 ,这 样 当 你 在 Java 代码 中 需要 通过 
findViewByld("id") 方 法 来 获取 该 控件 ,而 又 忘 了 该 控件 id 时 ,可 以 方便 快速 地 定位 到 该 控 
件 的 id 属性 。 

© Android 项 目 结构 中 的 src 目录 下 存放 着 Android 项 目的 源 代码 ,该 目录 下 的 cn\ 
edu\hstc\firstapp 目录 下 有 一 个 MainActivity. java 文件 , 它 就 是 Android 项 目的 Java X 
件 ,用 于 控制 FirstApp 项 目的 业务 实现 。 双 击 该 文件 ,将 其 中 的 源 代码 如 下 所 示 进 行 修改 。 


package cn. edu. hstc. firstapp; 





import android. app. Activity; 
import android. os. Bundle; 
import android. view. View; 
import android. widget. Button; 
import android. widget.EditText; 
import android. widget. TextView; 


public class MainActivity extends Activity ( 
/ xx 
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* 声明 布局 文件 中 的 各 个 组 件 
x*/ 
private TextView title; 
private EditText show; 
private Button confirm; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R. layout. activity main); 
initView(); 


) 


/ xx 
* 初始 化 界面 控件 
*/ 
private void initView() { 
// 通 过 ID 获取 TextView 组件 
title = (TextView) this.findViewById(R. id.txt title); 
// 通 过 ID 获取 EditText 组 件 
show = (EditText) this.findViewById(R. id. edt show); 
// 通 过 ID 获取 Button 组 件 
confirm = (Button) this.findViewById(R. id.btn confirm); 
// Jy Button 控件 绑 定 一 个 单 击 事件 监听 器 
confirm.setOnClickListener(new View.OnClickListener() ( 
(2 Override 
public void onClick(View arg0) ( 
// 将 EditText 中 所 填 人 的 内 容 显示 在 TextView 中 
title. setText(show. getText(). toString().trin()); 


n; 


代码 文件 : codes\01\1. 4\FirstApp\src\cn\edu\hstc\firstapp\MainActivity. java 


至 此 ,这 个 HelloWorld 级 别 的 Android 应 用 已 经 开发 完成 。 

在 上 面 所 介绍 的 步骤 中 ,显然 ,Android 将 用 户 界面 交 给 XML 文档 来 定义 ,而 Java fé 
序 则 专门 负责 业务 实现 ,这 样 降 低 了 程序 的 耦合 性 。 这 与 读者 熟悉 的 MVC 设计 模式 也 是 
有 所 相似 的 。 其 实 我 们 可 以 将 XML 界面 文件 看 成 是 一 个 HTML 页 面 文件 ,只 不 过 
Android 界面 文件 遵循 XML 文档 格式 ,并 使 用 Android 标签 ,而 HTML 页 面 文 件 使 用 
HTML 的 内 置 标签 。 


1.4.2 通过 模拟 器 运行 Android 应 用 


想 要 将 Android 应 用 运行 在 模拟 器 上 十 分 简单 ,只 要 按照 如 下 步骤 操作 即 可 。 

(D 参照 1.3.2 节 中 的 介绍 ,将 指定 AVD 设备 启动 起 来 。 

© 在 Eclipse 的 包 浏 览 器 中 选中 需要 运行 的 Android M H ,然后 右 击 ,在 弹出 的 菜单 中 
单 击 Run As— Android Application 命令 ,如 图 1. 23 所 示 ,等 待 片刻 , 即 可 看 到 该 Android 
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应 用 已 经 部 署 到 模拟 器 上 。 





图 1.23 运行 Android 应 用 
完成 第 二 步 操作 后 , 稍 等 片刻 ,就 可 以 在 原先 启动 的 那 台 AVD 设备 中 看 到 如 图 1. 24 
所 示 的 Android 应 用 部 署 完成 后 的 界面 。 


CE cA Um 
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第 一 个 Android 应 用 




















图 1.24 部 署 Android 应 用 


在 如 图 1. 24 所 示 界 面 的 文本 编辑 框 中 输入 “Hello Android”, 然 后 单 击 “ 单 击 确定 ” 按 
钮 , 即 可 看 到 图 中 的 “我 的 第 一 个 Android 应 用 ” 变 成 了 “Hello Android”, 如 图 1. 25 所 示 。 

如 果 想 要 在 图 1. 25 中 的 文本 编辑 框 中 输入 中 文 , 则 可 以 进行 以 下 步骤 。 

CD 将 鼠标 指针 放 于 图 1. 25 中 的 文本 编辑 框 上 ,长 按 鼠 标 左 键 , 出 现 如 图 1. 26 所 示 的 
界面 。 

© 在 如 图 1. 26 所 示 的 界面 中 , 单 击 Input method 选项 ,出现 如 图 1. 27 所 示 界 面 ,选中 
“谷歌 拼音 输入 法 ?选项 ,返回 如 图 1. 25 所 示 的 界面 ,此 时 就 可 以 在 文本 编辑 框 中 输入 中 
Xr. 
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第 一 个 Android 应 用 


Hello Android 


Hello Android| 











图 1.25 运行 Android 应 用 


Select all 
Select text 
Cut all 


Copy all 


Input method 


Add "Android" to dictionary 





图 1.26 输入 法 设置 
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| (© select input method 


Android keyboard 


谷歌 拼音 输入 法 


Japanese IME 





图 1.27 选择 输入 法 


E 
(1.5 Android 应 用 程序 架构 
dd 

现在 ,读者 应 该 已 经 学 会 如 何 新 建 一 个 Android 项 目 以 及 开发 Android 项 目的 流程 了 ， 
即 在 XML 文件 中 定义 用 户 界 面 ,然后 打开 Java 源 代码 编写 业务 实现 。 但 是 ,读者 也 许 现在 
对 上 面 的 Java 源 文件 的 代码 还 不 是 很 理解 ,例如 “findViewByld(R. id. showTextView);” 
代码 中 的 R. id. showTextView 参数 是 从 何 而 来 等 等 ,对 Android 应 用 程序 的 项 目 结构 也 存 

实际 上 ,这 些 问 题 的 答案 并 不 太 难 , 接 下 来 对 如 图 1. 22 所 示 的 Android 项 目 应 用 结构 
做 一 个 简单 介绍 。 

src 目录 只 是 一 个 普通 的 ,存放 Java 源 文件 的 目录 ,这 里 不 做 详细 介绍 ,下 面 介 绍 的 是 
除 src 以 外 的 其 他 目录 结构 。 


1.5.1 自动 生成 的 gen 目录 


gen 目录 中 存放 所 有 由 Android 开发 工具 自动 生成 的 文件 。 该 目录 中 最 重要 的 就 是 
R.java 文件 。 这 个 文件 是 由 Android 开发 工具 AAPT 工具 根据 应 用 中 的 资源 文件 自动 产 
生 的 。Android 开发 工具 会 自动 根据 你 放 入 res 目录 的 XML 界面 文件 .图 标 与 常量 ,同步 更 
新 修改 R. java 文件 。 正 因为 R.java 文件 是 由 开发 工具 自动 生成 的 ,所 以 应 避免 手工 修改 
R. java, R. java 在 应 用 中 起 到 了 资源 字典 的 作用 , 它 包含 了 界面 图标、 常量 等 各 种 资源 的 
id, 通 过 R.java, 应 用 可 以 很 方便 地 找到 对 应 资源 。 另 外 编译 器 也 会 检查 R. java 列表 中 的 
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资源 是 否 被 使 用 到 ,没有 被 使 用 到 的 资源 不 会 编译 进 软件 中 ,这 样 可 以 减少 应 用 在 手机 中 占 
用 的 空间 。 打 开 gen/cn/edu/hstc/firstapp 目录 下 的 R. java 文件 ,可 以 看 到 如 下 代码 。 


package cn. edu. hstc. firstapp; 


public final class R{ 

public static final class attr { 

} 

public static final class dimen { 
public static final int activity horizontal margin= 0x7f040000; 
public static final int activity vertical margin = 0x7f040001; 

) 

public static final class drawable ( 
public static final int ic launcher - 0x7f020000; 

) 

public static final class id { 
public static final int action settings = 0x7f080003; 
public static final int btn confirm = 0x7f080002; 
public static final int edt show = 0x7f080001; 
public static final int txt title = 0x7f080000; 

) 

public static final class layout { 
public static final int activity main = 0x7f030000; 

i 

public static final class menu { 
public static final int main = 0x7f070000; 

) 

public static final class string { 
public static final int action settings = 0x7f050001; 
public static final int app name = 0x7f050000; 
public static final int confirm = 0x7f050003; 
public static final int hello world = 0x7f050002; 

) 

public static final class style ( 
public static final int AppBaseTheme = 0x7£060000; 
public static final int AppTheme = 0x7£060001; 


代码 文件 : codes\01\1.4\FirstApp\gen\cn\edu\hstc\firstapp\R. java 


从 上 面 的 源 代码 文件 可 以 看 到 : 

所 在 R 类 中 ,针对 各 种 资源 生成 了 对 应 的 内 部 类 。 例 如 界面 布局 资源 对 应 layout 内 部 
类 ; 字符 串 资源 对 应 string 内 部 类 ; 标识 符 资源 对 应 id 内 部 类 。 

忌 每 个 内 部 类 中 以 一 个 public static final int 类 型 的 Field 来 对 应 每 个 具体 的 资源 项 。 
例如 前 面 在 activity main. xml 文件 中 设置 了 Button 控件 的 id 属性 为 confirmButton 以 
及 设置 了 EditText 控件 的 id 属性 为 showEditText, 因 此 R. id 类 中 就 定义 了 这 两 个 
Field; 由 于 我 们 有 一 个 名 为 activity. main. xml 的 布局 文件 ,所 以 在 R. layout 类 中 就 
有 了 activity main 的 Field. 
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1.5.2 资源 目录 res 


Android 应 用 的 res 目录 中 存放 了 包括 XML 界面 文件 .图 片 资 源 、 字 符 串 资源 、 颜 色 资 
源 .尺寸 资源 等 在 内 的 Android 应 用 所 用 的 全 部 资源 。 
通过 展开 Android 项 目的 结构 目录 中 的 res 目录 ,可 以 看 到 layout, values, drawable 等 
资源 文件 夹 ,这 些 文件 夹 对 不 同 的 资源 进行 了 分 类 ,这 样 可 以 方便 地 让 AAPT 工具 来 扫描 
这 些 资源 ,并 在 R. java 文件 中 为 它们 生成 对 应 的 内 部 类 。 下 面 对 各 个 资源 文件 夹 做 一 个 简 
单 的 介绍 。 
名 Tres/drawable: 专门 存放 png、jpg 等 图 片 文件 。 在 Java 代码 中 使 用 getResources(). 
getDrawable(resourceId) 获 取 该 目录 下 的 资源 。 
Zr res/layout: 专门 存放 XML 界面 文件 ,XML 界面 文件 和 HTML 文件 一 样 ,主要 用 于 
显示 用 户 操作 界面 。 
Zres/ values: 专门 存放 应 用 使 用 到 的 各 种 类 型 数据 。 不 同类 型 的 数据 存放 在 不 同 的 
文件 中 ,如 下 : 
(D strings. xml 一 一 定义 字符 串 和 数组 ,在 Activity 类 中 使 用 getResources CO). 
getString(resourceld) 或 getResourcesO. getText(resourceld) 来 取得 字符 串 资源 。 它 的 作 
用 和 struts 中 的 国际 化 资源 文件 一 样 。 一 份 strings. xml 文件 的 内 容 如 下 : 


<?xml version= "1.0" encoding = "utf - 8"?> 
<resources> 
< string name = "app_name"> FirstApp </string> 
< string name = "action settings"> Settings </string> 
< string name = "hello_world"> 我 的 第 一 个 安 卓 应 用 </string> 
< string name = "confirm"> 确 定 </string> 
</resources > 
代码 文件 : codes\01\1. 4\FirstApp\res\values\strings. xml 


在 Java 代码 中 使 用 getResources(). getString CR. string. app. name) 或 getResources C). 
getText(R. string. app_name) 来 获取 key 为 app. name 的 值 。 

在 XML 中 使 用 @string/app_name 来 获取 key 为 app. name 的 值 。 

© arrays. xml; 定义 数组 。 一 份 arrays. xml 文件 的 内 容 如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 
< resources > 
< string- array name = "colors"> 
< item» red </ item> 
< item» yellow </item> 
< item > green </ item> 
< item» blue </item> 
«/string- array> 
</resources > 
代码 文件 : codes\01\1. 4\FirstApp\res\values\arrays. xml 


@ colors. xml; 定义 颜色 和 颜色 字 串 数值 ,可 以 在 Activity 中 使 用 getResources O. 
getDrawable(resourceld) 以 及 getResources(). getColor(resourceld) 取 得 这 些 资源 。 一 份 
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colors. xml 文件 的 内 容 如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 
« resources » 
< color name = "contents text"»itff0000 </color> 
</resources > 
代码 文件 : codes\01\1.4\FirstApp\res\values\colors. xml 


CD dimens. xml; 定义 尺寸 数据 ,在 Activity 中 使 用 getResources ( ). getDimension 
《resourceld) 取 得 这 些 资源 。 一 份 dimens. xml 文件 的 内 容 如 下 : 


< resources > 
<! -- Default screen margins, per the Android Design guidelines. --> 
< dimen name = "activity horizontal margin"» 16dp </dimen > 
< dimen name = "activity vertical margin"» 16dp «/dimen» 
«/resources > 
代码 文件 : codes\01\1. 4\FirstApp\res\values\dimens. xml 


© styles. xml: 定义 样式 。 一 份 styles. xml 文件 的 内 容 如 下 : 


< resources > 
< style name = "AppBaseTheme" parent = "android:Theme.Light"> 
< item name = "android:textSize"> 18sp </item> 
< item name = "android: textColor"># 0066FF </item> 
</style> 


< style name = "AppTheme" parent = "AppBaseTheme"> 
</style> 
</resources > 
代码 文件 : codes\01\1. 4\FirstApp\res\values\styles. xml 
Zres/anim; 存放 定义 动画 的 XML 文件 。 
zr res/ xml: 在 Activity 中 使 用 getResourcesO. getXML() 读 取 该 目录 下 的 XML 资源 
文件 。 
Zrres/raw; 该 目录 用 于 存放 应 用 使 用 到 的 原始 文件 ,如 音效 文件 等 。 编 译 软件 时 ,这 
些 数据 不 会 被 编译 ,它们 被 直接 加 入 到 程序 安装 包 里 。 为 了 在 程序 中 使 用 这 些 资 源 ， 
可 以 调用 getResources(). openRawResource(resourcesId) 来 获取 资源 。 
Android 除了 提供 res 目录 存放 资源 文件 外 ,assets 目录 也 可 以 存放 资源 文件 ,而 且 
assets 目录 下 的 资源 文件 不 会 在 R.java 中 自动 生成 ID, 所 以 读 取 assets 目录 下 的 文件 必须 
指定 文件 的 路 径 , 如 : file:///android_asset/xxx. 3gp。 


1.5.3 项 目 清单 文件 : AndroidManifest. xml 


AndroidManifest. xml 清单 文件 是 每 个 Android 项 目 都 必需 的 , 它 是 整个 Android 应 
用 的 全 局 描述 文件 。 这 个 文件 列 出 了 应 用 程序 所 提供 的 功能 ,以 后 开发 好 的 各 种 组 件 需要 
在 该 文件 中 进行 配置 ,如 果 应 用 使 用 到 了 系统 内 置 的 应 用 (如 电话 服务 .互联 网 服务 ,短信 服 
GPS 服务 等 等 ) ,还 需 在 该 文件 中 声明 使 用 权限 。 

AndroidManifest. xml 清单 文件 说 明了 该 应 用 的 名 称 、 所 使 用 图 标 以 及 包含 的 组 件 等 ， 
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一 份 AndroidManifest. xml 文件 的 内 容 如 下 : 


<?xml version = "1.0" encoding = "utf - 8"?> 

<! -- 指定 该 Android 应 用 的 唯一 包 名 ,该 包 名 可 唯一 表示 该 应 用 -一 > 

< manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
package = "cn. edu. hstc. firstapp" 
android:versionCode - "1" 
android:versionName = "1.0" > 


« uses - sdk 
android:minSdkVersion - "18" 
android:targetSdkVersion = "18" /> 


<! —— 指定 Android 应 用 标签 ,图标 --> 
« application 
android:allowBackup = "true" 
android: icon = "(Qdrawable/ic launcher" 
android: label = "@string/app_name" 
android: theme = "@style/AppTheme" > 
<! -- 为 该 应 用 定义 一 个 Activity 组 件 ,并 指定 该 Activity 的 标签 --> 
«activity 
android:name = "cn. edu. hstc. firstapp. MainActivity" 
android: label = "(Qstring/app name" > 
< intent - filter > 
<! -一 指定 该 Activity 是 程序 的 入 口 --> 
< action android:name = "android. intent. action. MAIN" /> 
<! -- 指定 加 载 该 应 用 时 运行 该 Activity --» 
< category android:name = "android. intent. category. LAUNCHER" /> 
«/intent - filter» 
«/activity» 
«/application» 


</manifest > 
代码 文件 : codes\01\1. 4\FirstApp\AndroidManifest. xml 
由 以 上 文件 内 容 可 以 看 出 ,AndroidManifest. xml 清单 文件 通常 包含 如 下 信息 : 
如 应 用 程序 的 包 名 ,该 包 名 将 会 作为 该 应 用 的 唯一 标识 。 
总 应 用 程序 所 包含 的 组 件 , 如 Activity、Service、BroadcastReceiver 和 ContentProvider 等 。 
气 应 用 程序 兼容 的 最 低 版 本 。 
名 应 用 程序 使 用 系统 所 需 的 权限 声明 。 
如 其 他 程序 访问 该 程序 所 需 的 权限 声明 。 
随 着 不 断 地 进行 开发 ,可 能 需要 对 AndroidManifest. xml 清单 文件 进行 适当 的 修改 。 


1.5.4 声明 应 用 程序 使 用 权限 


上 面 提 到 ,如 果 应 用 使 用 到 了 系统 内 置 的 应 用 (如 电话 服务 、 互 联网 服务 、 短 信服 务 、 
GPS 服务 等 ) ,还 需 在 该 文件 中 声明 使 用 权限 ; 一 个 应 用 也 可 能 被 其 他 应 用 调用 ,因此 也 需 
要 声明 调用 自身 所 需要 的 权限 。 


(S^ Android 应 用 开发 从 入 门 到 精通 


1. 声明 该 应 用 自身 所 拥有 的 权限 


通过 为 < manifest.../> 元 素 添 加 < uses-perrnission.../> 子 元 素 即 可 为 自身 声明 权限 。 
例如 ,在 < manifest.../> 元 素 中 添加 如 下 代码 : 


<! -- 声 明 该 应 用 本 身 即 有 打 电 话 的 权限 -一 > 


< uses - permission android:name = "android. permission. CALL PHONe"/> 


2. 声明 调用 该 应 用 自身 所 需 的 权限 


通过 为 应 用 的 各 组 件 元 素 , 如 < activity.../> 元 素 添 加 < uses-permission.../> 子 元 素 即 可 
声明 调用 该 程序 所 需 的 权限 。 

例如 ,在 < activity..…./> 元 素 中 添加 如 下 代码 : 

<! -- 声明 该 应 用 本 身 即 有 打 电话 的 权限 --> 

< uses - permission android:name = "android. permission. SEND_SMS"/> 

下 面 给 出 一 些 Android 系统 常用 权限 ,这 些 权 限 都 可 以 通过 Android 官方 文档 查看 到 。 

名 开机 自动 允许 一 一 android. permission. RECEIVE_BOOT_COMPLETED, 允许 程序 
开机 自动 运行 。 

名 电量 统计 一 一 android. permission. BATTERY_STATS, 获 取 电 池 电 量 统计 信息 。 

名 使 用 蓝牙 一 一 android. permission. BLUETOOTH ,允许 程序 连接 配对 过 的 蓝牙 
设备 。 

所 蓝牙 管理 一 一 android. permission. BLUETOOTH_ADMIN ,允许 程序 发 现 和 配对 新 
的 蓝牙 设备 。 

名 收 到 短信 时 广播 一 android. permission. BROADCAST_SMS, 当 收 到 短信 时 触发 一 
Ard. 

如 拨打 电话 一 一 android. permission. CALL_PHONE, 允许 程序 从 非 系统 拨号 器 里 输 
入 电话 号 码 。 

名 拍照 权限 一 一 android. permission. CAMERA ,人 允许 访问 摄像 头 进 行 拍 照 。 

名 安装 应 用 程序 一 一 android. permission. INSTALL_PACKAGES, 允许 程序 安装 
应 用 。 

M ic dE ETE android. permission. MODIFY_AUDIO_SETTINGS ,修改 声音 设 
置信 息 。 

M cB WIR S android. permission. MODIFY_PHONE_STATE, 修 改 电话 状态 ， 
如 飞行 模式 ,但 不 包含 替换 系统 拨号 器 界面 。 

如 读 取 日 程 提醒 一 一 android. permission. READ. CALENDAR. ,人 允许 程序 读 取 用 户 的 
日 程 信息 。 

如 读 取 联系 人 一 一 android. permission. READ_CONTACTS, 允许 应 用 访问 联系 人 通 
讯 录 信息 。 

也 屏幕 截图 一 一 android. permission. READ FRAME BUFFER , 读 取 帧 缓存 用 于 屏幕 
截图 。 
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ac US LEE android. permission. READ SMS. i BUS fii NA. 

名 接收 彩信 一 一 android. permission. RECEIVE MMS. ,接收 彩信 。 

名 接收 短信 一 一 android. permission. RECEIVE_SMS ,接收 短信 。 

名 录音 一 一 android. permission. RECORD_AUDIO, 录 制 声 音 通过 手机 或 耳机 的 麦克 。 

名 发 送 短 信 一 一 android. permission. SEND_SMS ,发 送 短信 。 

e VEL] 5 HE RE —— com. android. alarm. permission. SET ALARM. i [i] £5 5 B, 

名 设置 系统 时 间 一 一 android. permission. SET_TIME, 设 置 系统 时 间 。 

名 使 用 振动 一 一 android. permission. VIBRATE, 人 允许 振动 。 

名 写 人 联系 人 一 一 android. permission. WRITE_CONTACTS, 写 入 联系 人 ,但 不 可 
读 取 。 

如 写 人 外 部 存储 一 一 android. permission. WRITE_EXTERNAL_STORAGE, 人 允许 程 
序 写 入 外 部 存储 即 SD 卡 上 写 文件 。 

名 编写 短信 一 一 android. permission. WRITE_SMS ,人 允许 编写 短信 o 

扣 访 问 网 络 一 一 android. permission. INTERNET. ,人 允许 访问 网 络 。 

切 修 改 文件 系统 一 一 android. permission. MOUNT UNMOUNT  FILESYSTEMS. fù 
许 创 建 修改 或 删除 文件 。 


0.6 Android 应 用 的 基本 组 件 介绍 


一 个 或 多 个 基本 组 件 组 成 了 丰富 多 彩 的 Android 应 用 。 前 面 提 到 的 Activity 就 是 
Android 四 大 组 件 之 一 ,其 他 三 个 为 Service (服务 )、ContentProvider (内 容 提供 者 )、 
BroadcastReceiver( 广 播 接收 器 ) 。 实 际 上 ,Android 并 不 只 有 这 四 大 组 件 , 还 有 其 他 的 一 些 
组 件 ,这 些 组 件 才 构 成 了 强大 的 功能 丰富 的 Android 应 用 。 下 面 先 对 这 些 组 件 做 一 个 简单 
的 介绍 ,后 面 章节 会 进一步 详细 介绍 每 一 个 组 件 。 


1.6.1 Activity 


应 用 程序 中 ,一 个 Activity 通常 就 是 一 个 单独 的 屏幕 ,作为 与 用 户 交互 的 组 件 , 它 上 面 

可 以 显示 一 些 控件 ,也 可 以 监听 和 处 理 用 户 的 事件 并 做 出 响应 。Activity 通过 
setContentView() 显 示 指 定 的 组 件 。 该 方法 可 以 接收 一 个 View 对 象 作为 参数 ,也 可 以 接 
收 一 个 布局 资源 id 作为 参数 。 但 通常 采用 后 者 。 图 1. 28 分 别 采用 了 这 两 种 方式 设置 了 
Activity 中 所 显示 的 View。 

/7/ 创 建 一 个 线性 布局 * 

LinearLayout layout = new LinearLayout (this);« 

/7 接收 一 个 Wiew HR. RE Activity 显示 该 layouty 

Super. setContentVi ew Layout) ; e 

/接收 一 个 布局 资源 id， 设置 Activity 显示 activity aain. xal 文件 中 定义 的 Yievw 


getContent9iew(R.layout, activity main);« 


图 1.28 显示 Activity 
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Activity 组 件 继 承 Activity 基 类 并 且 有 自己 的 生命 周期 ,这 将 在 后 面 继续 做 深入 的 介 
绍 。 多 个 Activity 构成 了 Android 应 用 的 Activity 栈 , 当 前 活动 的 Activity 位 于 栈 顶 。 


1.6.2 Service 


与 Activity 组 件 继承 Activity 基 类 相似 ,Service 组 件 需 要 继承 Service 基 类 。 不 同 的 
是 ,Service 没有 自己 的 用 户 界面 ,通常 位 于 后 台 运 行 ,用 于 开发 监控 类 程序 ,为 其 他 组 件 提 
供 后 台 服 务 或 监控 其 他 组 件 的 运行 状态 。 

服务 不 能 自己 运行 ,需要 通过 Contex. startService ) 或 Contex. bindService() 启 动 服 
F ,服务 一 旦 启动 , 便 有 了 自己 独立 的 生命 周期 。 


1.6.3 BroadcastReceiver 


顾名思义 ,BroadcastReceiver 代表 广播 接收 者 。 你 的 应 用 可 以 使 用 它 对 外 部 事件 进行 
过 滤 一 一 只 对 感 兴趣 的 外 部 事件 (如 当 电话 呼 入 时 ,或 者 数据 网 络 可 用 时 ) 进 行 接收 并 做 出 
响应 。 广 播 接收 器 没有 用 户 界面 ,但 它们 可 以 启动 一 个 activity 或 serice 来 响应 它们 收 到 的 
信息 ,或 者 用 NotificationManager 来 通知 用 户 。 

开发 自己 的 BroadcastReceiver 的 步骤 如 下 : 

(D 写 一 个 继承 BroadCastReceiver 的 类 , 重 写 onReceive (Context context. Intent 
intent) 方 法 ,广播 接收 器 仅 在 它 执行 这 个 方法 时 处 于 活跃 状态 。 当 onReceive() 返 回 后 , 它 
即 为 失 活 状 态 。 注 意 : 为 了 保证 用 户 交互 过 程 的 流畅 ,一 些 费 时 的 操作 要 放 到 线程 里 ,如 
SMSBroadcastReceiver。 

@ 注册 该 广播 接收 者 ,注册 有 两 种 方法 : 程序 动态 注册 和 在 AndroidManifest 文件 中 
进行 静态 注册 (可 理解 为 系统 中 注册 ) ,如 图 1. 29 和 图 1. 30 所 示 。 


«receiver android:name-".SMSBroadcastReceiver" > 
cintent-filter android:priority = "2147483647" > 
«action android:nare-"android.provider.Telephony.SMS RECEIVED" /> 
«/intenz-filver» 
€/receiver > 


图 1.29 静态 注册 


IntentFilter intentFilter=new IntentFilter("android.provider.Telephory.SMS RECEIVED"); 
zegisterReceiver(mBatteryInfoReceiver ,intentFilter); 


LESER 
unregisterReceiver (receiver); 


图 1.30 动态 注册 


各 静态 注册 ,在 AndroidManifest. xml 文件 中 使 用 < receiver.../> 元 素 完成 注册 。 下 面 
的 priority 属性 表示 接收 广播 的 级 别 ,"2147483647" 为 最 高 优先 级 。 
总 动态 注册 ,在 Java 代码 中 通过 Context. registReceiver() 方 法 注册 该 BroadcastReceiver。 
广播 有 三 种 类 型 : 普通 广播 ,通过 Context. sendBroadcast() 发 送 ; 有 序 广播 ,通过 
Context. sendOrderedBroadcast() 发 送 ; 异步 广播 ,通过 Context. sendStickyBroadcast() 发 
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送 。 不 管 是 何 种 广播 类 型 ,如 果 BroadcastReceiver 也 对 该 消息 “ 感 兴趣 ”( 通 过 IntentFilter 
配置 ) , 则 BroadcastReceiver 的 onReceive (Context context. Intent intent) 方法 将 会 被 
触发 。 


1.6.4 ContentProvider 


Android 平台 提供 了 ContentProvider 使 一 个 应 用 程序 的 指定 数据 集 提 供给 其 他 应 用 
程序 。 这 些 数据 可 以 存储 在 文件 系统 、 一 个 SQLite 数据 库 中 ,或 以 任何 其 他 合理 的 方式 存 
储 , 其 他 应 用 可 以 通过 ContentResolver 类 从 该 内 容 提 供 者 中 获取 或 存 和 数据。 一 个 应 用 
程序 使 用 ContentProvider 暴露 自己 的 数据 ,而 另 一 个 应 用 程序 则 通过 ContentResolver 来 
访问 数据 。 

只 有 需要 在 多 个 应 用 程序 间 共 享 数据 时 才 需 要 内 容 提 供 者 。 例 如 ,我 们 开发 了 一 个 发 
送 短信 的 程序 , 当 发 送 短信 时 需要 从 联系 人 管理 应 用 中 读 取 指定 联系 人 的 数据 一 一 这 就 需 
要 多 个 应 用 程序 之 间 进 行 实 时 的 数据 交换 。 

Android 系统 为 这 种 跨 应 用 的 数据 交换 提供 了 一 个 标准 : ContentProvider。 当 用 户 实 
现 自己 的 ContentProvider 时 ,需要 实现 如 下 抽象 方法 。 

ginsert(Uri, ContentValues) — [8] ContentProvider 插入 数据 。 

4 deleteCUri, ContentValues) 一 一 删除 ContentProvider 中 指定 数据 。 

 udpateCUri, ContentValues. String. String[ D — E Ji ContentProvider 中 指定 

数据 。 

a queryCUri, String[ ]. String. String[ ]. String) —— M ContentProvider 查询 数据 。 


(1.7 本 章 小 结 


本 章 简要 介绍 了 Android 应 用 开发 的 背景 知识 ,包括 什么 是 Android, Android 的 平台 
架构 。 读 者 阅读 本 章 需 要 掌握 的 重点 是 如 何 搭建 Android 的 开发 环境 ,包括 下 载 、 安 装 、 使 
HADT TH; 下 载 和 安装 Android SDK、 如 何 使 用 Android 模拟 器 。 这 些 内 容 是 开发 
Android 应 用 的 基础 。 除 此 之 外 ,本 章 还 介绍 了 一 个 Android 的 Hello World 级 别 的 应 用 ， 
通过 该 应 用 向 读者 介绍 开发 Android 应 用 的 一 般 流程 并 向 读者 分 析 了 Android 应 用 的 目录 
结构 。 最 后 ,本章 简单 介绍 了 Android 的 四 大 组 件 , 让 读者 对 这 四 大 组 件 有 了 一 个 基本 了 
解 。 通 过 阅读 本 章 ,读者 应 该 已 经 具备 了 开发 Android 应 用 的 一 些 基 本 知识 了 。 





0.1 基于 监听 的 事件 响应 
- 


在 认识 各 种 Android UI 控件 之 前 ,我们 先 来 学 习 对 程序 界面 上 执行 的 各 种 操作 作出 响 
应 ,这 些 响应 都 是 通过 事件 处 理 来 完成 的 。 实 际 上 ,在 第 1 章 介绍 布局 的 时 候 , 已 经 出 现 了 
部 分 Android 的 UI 控件 了 。 对 于 这 些 控件 的 详细 介绍 ,将 在 第 3 章 进 行 讲解 。 之 所 以 将 
对 UI 的 各 种 事件 控制 的 介绍 放 在 介绍 UI 控件 之 前 ,是 因为 在 讲解 各 种 控件 的 时 候 需要 结 
合 对 具体 控件 的 事件 处 理 , 如 果 不 提 前 认识 这 些 事件 处 理 , 就 会 加 大 学 习 的 难度 。 学 习 事 件 
处 理 时 所 出 现 的 控件 ,大 部 分 都 是 比较 简单 的 控件 ,只 起 到 显示 界面 的 作用 ,难度 并 不 大 , 读 
者 在 这 一 章 只 需 知道 有 这 个 控件 就 可 以 了 。 

Android 提供 了 基于 监听 器 的 事件 处 理 以 及 键盘 事件 .触摸屏 事件 等 基于 回调 的 事件 
处 理 模 式 。 结 合 这 两 种 事件 处 理 机 制 , 相 信 读 者 可 以 开发 出 更 多 丰富 多 彩 的 功能 。 下 面 首 
先 介绍 Android 基于 监听 机 制 的 事件 处 理 模 式 。 


2.1.1 第 一 种 响应 方法 
这 里 将 用 一 个 实例 来 介绍 第 一 种 响应 方法 , 先 看 以 下 程序 界面 代码 。 





< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
xmlns: tools = "http://schemas. android. com/tools" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:background = "(Z color/azure" 
android:gravity = "center" 
android:orientation = "vertical" > 


« Button 
android:id- "(2 + id/btn add" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text- "+ " /> 


< TextView 
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android: id= "(2 + id/txt show" 
android:layout_width = 
android:layout height = "wrap content" 
android:text- "我 会 变 大 " 
android:textSize= "12sp" 
android:textStyle = "bold" /> 





wrap content" 


< Button 
android:id- "(2 + id/btn min" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "- " /> 


«/LinearLayout > 
代码 文件 : codes\02\2.1\FirstMethod\res\layout\activity main. xml 


上 面 的 界面 文件 非常 简单 ,只 是 在 一 个 线性 布局 中 添加 了 一 个 TextView 控件 ,用 来 显 
示 文 本 ,然后 添加 了 两 个 Button 按钮 ,用 来 与 用 户 进行 交互 ,三 个 控件 自 上 而 下 排列 。 接 下 
来 的 程序 代码 中 ,分 别 为 两 个 Button 按钮 添加 了 单 击 事件 处 理 。 


package cn. edu. hstc. firstmethod; 


import android. app. Activity; 
import android. os. Bundle; 
import android. view. View; 
import android. widget. Button; 
import android. widget. TextView; 


public class MainActivity extends Activity { 
/xx 
* 声明 布局 文件 中 的 各 个 组 件 
*/ 
private TextView show; 
private Button btnAdd, btnMin; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity main); 
initView(); 


) 
private void initView() ( 
/ xx 
* 加 载 布局 文件 中 的 各 个 组 件 
*/ 


show = (TextView) this.findViewById(R. id. txt_show); 
btnAdd = (Button) this.findViewById(R. id. btn add); 
btnMin = (Button) this. findViewById(R. id. btn min); 


btnAdd. setOnClickListener(new View.OnClickListener() ( 
(QOverride 
public void onClick(View arg0) ( 


(s^ Android 应 用 开发 从 入 门 到 精通 


float fontSize = show.getTextSize(); 
if (fontSize « 36) { 
show. setText(" 我 会 变 大 或 变 小 "); 
show. setTextSize(++fontSize); 
btnMin. setEnabled(true); 
if (fontSize == 36) { 
show. setText(" 我 不 会 再 变 大 了 "); 
btnAdd. setEnabled(false); 


) 
np; 


btnMin. setOnClickListener(new View.OnClickListener() ( 
(QOverride 
public void onClick(View arg0) ( 
float fontSize = show.getTextSize(); 
if (fontSize» 12) ( 
show. setText(" 我 会 变 大 或 变 小 "); 
show. setTextSize( —— fontSize); 
btnAdd. setEnabled(true); 
if (fontSize == 12) { 
show. setText(" 我 不 会 再 变 小 了 "); 
btnMin. setEnabled(false); 


n; 


代码 文件 : codes\02\2. 1NFirstMethodV srcVcnVedu V hstc V £irstmethodVactivityN 

MainActivity. java 

在 上 面 的 程序 代码 中 ,实现 了 单 击 “十 "按钮 ,界面 ames 
中 的 文本 字号 变 大 ; 单 击 *-" 按 钮 ,界面 中 的 文本 字号 
变 小 。 当 字号 大 小 大 于 12 并 小 于 36 时 ,文本 内 容 为 
“我 会 变 大 或 变 小 ”, 并 且 两 个 按钮 皆 可 用 ; 当 字号 等 于 
12 时 ,文本 内 容 为 “我 不 会 再 变 小 了 ”, 并 且 “-” 按 钮 不 
可 用 ; 当 字号 大 小 为 36 时 ,文本 内 容 为 “我 不 会 再 变 大 


了 ”, 并 且 “ 十 "按钮 不 可 用 。 运 行 效果 如 图 2.1 所 示 。 p 

从 代码 文件 MainActivity. java 中 可 以 看 出 ,程序 BA AM 
通过 findViewByld 句柄 获得 界面 中 的 各 个 控件 ,这 里 我 不 会 再 变 大 了 
使 用 的 是 R. id. text, R. id. btnAdd 以 及 R. id. btnMin P 


作为 该 句柄 的 参数 , 即 传人 参数 为 界面 中 各 个 控件 所 
对 应 的 ID。 
接着 ,程序 通过 setOnClickListener 方法 为 界面 文 
件 中 的 两 个 Button 按钮 分 别 设置 了 单 击 事件 监听 器 ， 
这 个 方法 的 参数 实际 上 是 一 个 View. OnClickListener 图 2.1 控制 单 击 屏幕 字号 大 小 
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类 型 的 接口 ,这 个 接口 需要 onClick 方法 ,在 该 方法 中 , 则 是 实现 事件 处 理 的 具体 响应 。 为 
控件 注册 监听 器 其 实 是 一 种 委托 的 机 制 。 普 通 控件 将 整个 事件 处 理 委托 给 监听 器 , 当 指 定 
事件 发 生 时 ,就 通知 所 委托 的 监听 器 去 处 理 这 个 事件 。 








综 上 ,为 控件 添加 事件 监听 器 ,有 以 下 两 个 编程 要 点 : 

名 使 用 findViewById O4KJft XML 布局 文件 中 的 控件 。 

x lH setOnXXXListener ) 为 控件 添加 事件 处 理 监 听 器 。 

在 获取 控件 时 需要 强制 转换 成 相应 的 控件 类 型 ,如 上 面 MainActivity. java 中 的 


*btnAdd = (Button) this. findViewByld(R. id. btnAdd);” 将 基础 类 型 强制 转换 为 Button 
类 型 。 


实际 上 ,在 本 节 所 介绍 的 这 种 为 控件 设置 事件 处 理 监 听 器 的 方式 为 采用 匿名 内 部 类 作 


为 事件 监听 器 类 的 方式 , 即 第 一 种 响应 方式 。 接 下 来 的 小 节 将 为 读者 介绍 第 二 种 响应 方式 。 


2.1.2 第 二 种 响应 方法 
用 户 操作 界面 中 的 UT 控件 ,除了 上 面 所 述 的 第 一 种 响应 方法 之 外 ,还 有 其 他 几 种 响应 


方法 ,本 节 介 绍 第 二 种 响应 方法 , 即 Activity 本 身 直接 作为 事件 监听 器 。 如 下 源 代码 中 ,在 
同样 的 布局 文件 和 应 用 程序 下 实现 同样 的 功能 。 


package cn. edu. hstc. secondmethod; 


import android. app. Activity; 

import android. os. Bundle; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. Button; 

import android. widget. TextView; 


public class MainActivity extends Activity implements OnClickListener ( 
/x 
* 声明 布局 文件 中 的 各 个 组 件 
*/ 
private TextView show; 
private Button btnAdd, btnMin; 


@Override 

protected void onCreate( Bundle savedInstanceState) { 
super. onCreate( savedInstanceState) ; 
setContentView(R. layout. activity_main); 
// 加 载 TextView 组 件 
Show = (TextView) findViewById(R. id.txt show); 
// 加 载 增加 按钮 
btnAdd = (Button) findViewById(R. id. btn add); 
// 加 载 减少 按钮 
btnMin = (Button) findViewById(R. id. btn_min) ; 
// 为 增加 按钮 添加 事件 监听 器 
btnAdd. setOnClickListener(this); 
// 为 减少 按钮 添加 事件 监听 器 
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btnMin. setOnClickListener(this); 
) 


(QOverride 
public void onClick(View v) { 
float fontSize = show.getTextSize(); 
switch (v.getId()) ( 
case R. id. btn add: 
if (fontSize « 36) ( 
show. setText ("我 会 变 大 或 变 小 "); 
show. setTextSize( ++fontSize); 
btnMin. setEnabled(true); 
if (fontSize == 36) { 
show. setText( "我 不 会 再 变 大 了 "); 
btnAdd. setEnabled(false); 
} 
} 
break; 
Case R. id. btn_min: 
if (fontSize > 12) { 
show. setText ("我 会 变 大 或 变 小 "); 
show. setTextSize( -- fontSize); 
btnAdd. setEnabled(true); 
if (fontSize == 12) { 
show. setText(" 我 不 会 再 变 小 了 "); 
btnMin. setEnabled(false); 
} 
} 
break; 
default: 
break; 
} 


} 
代码 文件 : codes\02\2.1\SecondMethod\ src\cn\edu\ hstc\ secondmethodN activity V 


MainActivity. java 

上 面 的 程序 让 Activity 类 实现 了 OnClickListener 事件 监听 接口 ,并重 写 了 事件 处 理 器 
方法 onClick(View v) ,该 方法 内 定义 了 具体 的 实现 业务 。 当 某 个 控件 想 要 委托 该 实现 了 监 
听 器 接口 的 Activity 作为 事件 处 理 器 时 ,直接 将 this 作为 该 控件 注册 监听 器 的 方法 的 参数 
即 可 。 如 上 面 的 程序 代码 “btnAdd. setOnClickListener (this) ;". JU "4 ifj Activity 设置 为 
“十 ”按钮 的 事件 处 理 监听 器 。 

为 了 保证 不 同 的 控件 执行 不 同 的 操作 ,在 实现 onClick 方法 时 ,必须 使 用 switch 体 , 用 
各 个 控件 的 ID 作为 判断 条 件 ,实现 不 同 的 控件 响应 不 同 的 业务 。 运 行 效果 与 图 2. 1 一 致 ， 
这 里 不 再 重复 。 


2.1.3 第 三 种 响应 方法 
布局 不 变 ,本 节 采 用 第 三 种 响应 方法 实现 与 前 面 实例 同样 的 功能 。 实 现代 码 如 下 
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package cn. edu. hstc. thirdmethod; 


import android. app. Activity; 

import android. os. Bundle; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. Button; 

import android. widget. TextView; 


public class MainActivity extends Activity ( 
/ xx 
* 声明 布局 文件 中 的 各 个 组 件 
*/ 
private TextView show; 
private Button btnAdd, btnMin; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. activity main); 
// 加 载 Textview 组 件 
show = (TextView) findViewById(R. id. txt show); 
// 加 载 增加 按钮 
btnAdd = (Button) findViewById(R. id. btn add); 
// 加 载 减少 按钮 
btnMin = (Button) findViewById(R. id.btn min); 
// 为 增加 按钮 设置 事件 监听 器 
btnAdd. setOnClickListener(new BtnAddOnClickLinstener()); 
// 为 减少 按钮 设置 事件 监听 器 
btnMin. setOnClickListener(new BtnMinOnClickLinstener()); 


private final class BtnAddOnClickLinstener implements OnClickListener { 
@Override 
public void onClick(View v) { 
float fontSize - show.getTextSize(); 
if (fontSize « 36) ( 
show. setText( "我 会 变 大 或 变 小 "); 
show. setTextSize(-^-*fontSize); 
btnMin. setEnabled(true); 
if (fontSize == 36) { 
show. setText( "我 不 会 再 变 大 了 ") ; 
btnAdd. setEnabled(false); 


private final class BtnMinOnClickLinstener implements OnClickListener ( 
@Override 
public void onClick(View v) { 
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float fontSize = show.getTextSize(); 
if (fontSize> 12) ( 
show. setText( "我 会 变 大 或 变 小 "); 
show. setTextSize( —— fontSize); 
btnAdd. setEnabled(true); 
if (fontSize == 12) { 
show. setText(" Jk BEZE/N T"); 
btnMin. setEnabled(false); 


) 
代码 文件 : codes V 02 \ 2. 1X ThirdMethodV src V cn V edu V hstc \ thirdmethod \ activity V 


MainActivity. java 

在 上 述 的 代码 中 ,定义 了 两 个 内 部 类 ,这 两 个 内 部 类 都 实现 了 View. OnClickListener 接 
H ,并 在 onClick 方法 中 定义 了 有 具体 的 业务 。 接 着 ,为 界面 中 的 两 个 Button 控件 分 别 注册 了 事 
件 处 理 监 听 器 。 如 程序 代码 *btnAdd. setOnClickListener(new btnAddOnClickListener());”, 将 
btnAddOnClickListener 类 的 对 象 设置 为 btnAdd 按钮 的 事件 处 理 监听 器 。 运 行 效 果 与 第 
一 种 响应 方法 中 的 例子 一 致 ,此 处 不 再 袭 述 。 

这 种 将 内 部 类 作为 事件 处 理 监 听 器 类 的 方法 ,有 两 个 好 处 : 可 以 在 当前 类 中 复 用 该 监 
听 器 类 ; 该 监听 器 类 可 以 自由 访问 外 部 类 中 的 所 有 界面 组 件 。 这 两 个 优势 其 实 也 同样 是 上 
面 的 第 一 种 响应 方法 (使 用 匿名 内 部 类 作为 事件 监听 器 类 ) 以 及 第 二 种 响应 方法 (使 用 当前 
Activity 作为 事件 监听 器 类 ) 所 具备 的 。 只 是 接 下 来 第 四 种 响应 方法 一 一 使 用 外 部 类 作为 
事件 监听 器 类 就 没有 同时 具备 这 两 个 优势 了 。 


2.1.4 第 四 种 响应 方法 


在 同样 布局 以 及 同一 应 用 程序 下 ,实现 同样 功能 ,如 下 代码 中 使 用 的 是 第 四 种 事件 响应 
处 理 方法 。 由 于 采用 外 部 类 作为 事件 监听 器 类 ,所 以 必须 有 一 个 实现 了 事件 监听 器 接口 
View. OnClickListener 的 类 。 


package cn. edu. hstc. fourthmethod; 


import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget.Button; 

import android. widget. TextView; 


public class BtnOnClickLinstener implements OnClickListener ( 
/ xx 
* 声明 布局 文件 中 的 各 个 控件 
*/ 
private TextView show; 
private Button btnAdd, btnMin; 
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BtnOnClickLinstener(TextView show, Button btnAdd, Button btnMin) ( 


this.show = show; 
this.btnAdd - btnAdd; 
this.btnMin - btnMin; 


(QOverride 
public void onClick(View v) { 


float fontSize = show.getTextSize(); 


switch (v.getId()) ( 
case R. id. btn add: 
if (fontSize « 36) ( 


show. setText(" 我 会 变 大 或 变 小 "); 


show. setTextSize(-^*fontSize); 


btnMin. setEnabled(true); 
if (fontSize == 36) { 


show. setText( "我 不 会 再 变 大 了 "); 
btnAdd. setEnabled( false); 


} 
break; 
case R. id. btn min: 
if (fontSize» 12) ( 


show. setText(" 我 会 变 大 或 变 小 "); 
show. setTextSize( —— fontSize); 


btnAdd. setEnabled(true); 
if (fontSize == 12)( 


show. setText(" 我 不 会 再 变 小 了 "); 
btnMin. setEnabled(false); 


) 

break; 
default: 

break; 


代码 文件 : codes V 02 \ 2. 1 \ FourthMethod V src V cn V edu V hstc V fourthmethod \ listener V 


BtnOnClickListener. java 
package cn. edu. hstc. fourthmethod; 


import android. app. Activity; 
import android. os. Bundle; 
import android. view. Menu; 
import android. widget. Button; 
import android. widget. TextView; 


public class MainActivity extends Activity ( 
/ xx 
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* 声明 布局 文件 中 的 各 个 控件 
*/ 

private TextView show; 

private Button btnAdd, btnMin; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
// 加 载 TextView 组 件 
show = (TextView) findViewById(R. id. txt show); 
// 加 载 增加 按钮 
btnAdd = (Button) findViewById(R. id.btn add); 
// 加 载 减少 按钮 
btnMin = (Button) findViewById(R. id. btn min); 
// 为 增加 按钮 添加 事件 监听 器 
btnAdd. setOnClickListener(new BtnOnClickLinstener(show, btnAdd, btnMin)); 


// 为 减少 按钮 添加 事件 监听 器 
btnMin. setOnClickListener(new BtnOnClickLinstener(show, btnAdd, btnMin)); 


) 


(QOverride 

public boolean onCreateOptionsMenu(Menu menu) ( 
//Inflate the menu; this adds items to the action bar if it is present. 
getMenuInflater(). inflate(R. menu. main, menu); 
return true; 


| 代码 文件 : codes \ 02 \ 2. 1 \ FourthMethod \ src V en V edu V hstc V fourthmethod V activity V 

MainActivity. java 

上 面 的 程序 中 ,首先 定义 了 一 个 实现 了 View. OnClickListener 接口 的 外 部 类 
BtnOnClickListener ,在 该 外 部 类 中 重 写 了 onClick 方法 来 处 理 具体 业务 。 但 由 于 该 外 部 类 
不 能 直接 访问 Activity 中 的 控件 ,所 以 需要 通过 传 参 方式 来 间接 访问 。 接 着 在 Activity 类 
中 为 两 个 Button 控件 注册 了 事件 处 理 监 听 器 ,如 代码 行 *“btnAdd. setOnClickListener (new 
BtnOnClickListener(text, btnAdd. btnMin));”, 为 “十 ”按钮 注册 了 监听 器 ,委托 该 监听 器 
响应 具体 操作 ,而 该 监听 器 则 为 程序 定义 的 外 部 类 BtnOnClickListener。 

运行 效果 与 第 一 种 响应 方法 中 的 例子 一 致 ,此 处 不 再 袭 述 。 

实际 上 ,这 种 使 用 顶级 类 来 定义 事件 监听 器 类 的 方法 比较 少 用 ,因为 这 样 不 能 在 事件 监 
听 器 类 中 自由 访问 Activity 中 的 控件 ,除非 确实 有 多 个 界面 共享 同一 个 事件 监听 器 的 情况 。 


2.1.5 在 XML 界面 文件 中 指定 事件 处 理 方法 


上 面 讲 到 的 四 种 响应 方法 都 是 在 程序 中 为 控件 注册 事件 处 理 监 听 器 , 接 下 来 要 介绍 的 
这 种 响应 方法 是 在 XML 界面 文件 中 为 组 件 绑 定 事件 处 理 方法 。 如 下 XML 代码 文件 以 及 
„java 源 文件 ,在 同样 的 布局 以 及 相同 的 应 用 程序 下 ,实现 同样 的 功能 。 
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< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


xmlns:tools 


= "http: //schemas. android. com/tools" 


android:layout width- "match parent" 
android:layout height = "match parent" 
android:background = "(2 color/azure" 
android:gravity = "center" 


android:orientation = "vertical" > 


<! -- 为 控件 指定 onClick 属性 , 绑 定 事件 处 理 方法 btnAddClick --> 


< Button 
android 


android: 
android: 
android: 


android 


< TextView 


android: 
android: 
android: 
android: 
android: 
android: 


:id- "(9 + id/btn add" 

layout width = "wrap content" 
layout height = "wrap content" 
text-" 4" 

:onClick = "btnAddClick" /> 


id- "(à + id/txt show" 

layout width = "wrap content" 
layout height = "wrap content" 
text = "我 会 变 大 " 

textSize = "12sp" 

textStyle = "bold" /> 


<! -- 为 控件 指定 onClick 属性 , 绑 定 事件 处 理 方法 btnMinClick --> 


< Button 
android 
android 
android 
android 
android 


«/LinearLayout > 


:id- "(9 + id/btn min" 

:layout width = "wrap content" 
:layout height = "wrap content" 
:text 
:onClick = "btnMinClick" /> 





代码 文件 : codes\02\2. 1\xMLMethod\res\layout\activity_main. xml 


package cn. edu. hstc. xmlmethod; 


import android. app. Activity; 


import android. os. Bundle; 


import android. view. View; 
import android. widget. Button; 
import android. widget. TextView; 


public class MainActivity extends Activity ( 
private TextView show; 
private Button btnAdd, btnMin; 


(QOverride 


protected void onCreate(Bundle savedInstanceState) { 
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super. onCreate(savedInstanceState); 

setContentView(R. layout.activity main); 

// 加 载 TextView 组 件 

show = (TextView) findViewById(R. id. txt show); 

// 加 载 增加 按钮 

btnAdd = (Button) findViewById(R. id. btn add); 

// 加 载 减少 按钮 

btnMin = (Button) findViewById(R. id. btn min); 
) 


public void btnAddClick(View v) ( 
float fontSize = show.getTextSize(); 
if (fontSize < 36) ( 
show. setText(" 我 会 变 大 或 变 小 "); 
show. setTextSize(++fontSize); 
btnMin. setEnabled(true); 
if (fontSize == 36) { 
show. setText ("我 不 会 再 变 大 了 "); 
btnAdd. setEnabled(false); 


) 


public void btnMinClick(View v) { 
float fontSize = show.getTextSize(); 
if (fontSize» 12) ( 
show. setText( "我 会 变 大 或 变 小 "); 
show. setTextSize( —— fontSize); 
btnAdd. setEnabled(true); 
if (fontSize == 12) { 
show. setText(" 我 不 会 再 变 小 了 ") ; 
btnMin. setEnabled(false); 


代码 文件 : codes\02\2. 1NXMIMethodV src\cn\edu\hstc\xmlmethod\activity\MainActivity. java 


上 面 的 XML 代码 与 介绍 四 种 响应 方法 时 所 举例 子 的 XML 界面 文件 的 代码 基本 一 致 ， 
唯一 的 区 别 在 于 本 例 的 XML 界面 文件 中 的 两 个 Button 控件 都 指定 了 android:onClick 属 
性 ,并 给 出 属性 值 ,而 属性 值 则 是 在 MainActivity 类 中 分 别 定 义 的 事件 处 理 方法 的 方法 名 。 
如 代码 行 android:onClick 二 "btnAddClick" 为 十 ”按钮 绑 定 了 事件 处 理 方法 btnAddClick, 
而 在 MainActivity 类 中 定义 了 btnAddClick 方法 ,该 方法 内 则 是 具体 的 响应 内 容 。 当 界面 
中 的 “十 ”按钮 被 单 击 时 ,该 方法 将 会 被 激发 并 处 理 “ 十 ”按钮 上 的 单 击 事件 。 运 行 效果 与 前 
面 介绍 的 四 种 响应 方法 时 所 举例 子 的 运行 效果 一 致 ,此 处 不 再 袭 述 。 

其 实 , 大 多 数 Android 标签 都 支持 如 onClick .onLongClick 等 属性 ,这 种 属性 的 属性 值 
则 是 Activity 中 所 对 应 定义 的 事件 处 理 方法 的 方法 名 。 
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@.2 键盘 事件 


2.1 节 的 内 容 主要 为 读者 介绍 了 UI 控 件 基于 监听 机 制 的 事件 响应 方法 ,这 些 响应 方法 
也 是 Android UI 最 常见 的 响应 方法 。 读 者 掌握 了 这 些 响应 方法 就 已 经 基本 掌握 了 如 何 对 
操作 Android UI 执行 响应 了 。 但 是 ,有 时 候 用 户 也 需要 直接 操作 Android 手机 上 的 键盘 ， 
这 个 时 候 就 需要 直接 对 键盘 事件 进行 响应 了 。 本 节 将 介绍 基于 回调 机 制 的 键盘 事件 的 响应 
方法 。 


< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 
android:background = "(d)color/azure" 
android:gravity = "center" > 


< TextView 
android:id- "(à + id/show" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:textSize = "24sp" /> 


«/LinearLayout > 
代码 文件 : codes\02\2. 2VKeyboardEventVresMayoutVactivity main. xml 


上 面 的 XML 界面 文件 非常 简单 ,在 一 个 线性 布局 里 添加 了 一 个 TextView 控件 ,用 来 
在 后 面 显示 文本 。 接 下 来 的 程序 代码 控制 用 户 按 下 键盘 上 的 返回 键 , 在 界面 输出 文字 。 


package cn. edu. hstc. keyboardevent. acitivity; 


import android. app. Activity; 
import android. os. Bundle; 
import android. view. KeyEvent; 
import android. widget. TextView; 


public class MainActivity extends Activity ( 
private TextView show; 


protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity main); 
show = (TextView) findViewById(R. id. show) ; 

} 


(QOverrid 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
// 按 下 返回 键 , 同 时 没有 重复 按 ,event. getRepeatCount() == 0 表示 只 按 了 一 次 
if (keyCode == KeyEvent.KEYCODE BACK && event.getRepeatCount() == 0) { 
show. setText(" 您 刚刚 按 下 了 返回 键 "); 


(s^ Android 应 用 开发 从 入 门 到 精通 


) 
return false; 
) 
} 
代码 文件 : codes \ 02 \ 2. 2\ KeyboardEvent V src V cn V edu V hstc V keyboardevent V activity V 
MainActivity. java 


上 面 的 程序 代码 中 ,在 Activity 中 重 写 了 onKeyDown BME 2o 
Cint keyCode, KeyEvent event) 方 法 ,在 该 方法 中 , 实 
现 了 键盘 事件 。 参数 keyCode 为 按键 码 ,event 表示 按 
键 事件 ,其 中 包含 更 详细 的 内 容 。 在 本 例 中 ,按键 码 
keyCode— = KeyEvent. KEYCODE BACK 表示 用 户 
按 下 的 是 返回 键 。 该 方法 会 在 用 户 按 下 返回 键 时 被 回 
调 , 运 行 效果 如 图 2. 2 所 示 。 
实际 上 ,为 了 实现 回调 机 制 的 事件 处 理 , Android 
为 所 有 GUI 组 件 都 提供 了 一 些 可 重 写 的 事件 处 理 方 
法 ,以 View 为 例 ,该 类 包含 如 下 方法 。 
4 boolean onKeyDown (int keyCode, KeyEvent 
event): 当 用 户 在 该 组 件 上 按 下 某 个 按键 时 触 
发 该 方法 。 
4 boolean onKeyLongPress (int keyCode, KeyEvent 
event): 当 用 户 在 该 组 件 上 长 按 某 个 按键 时 触发 
该 方法 。 
boolean onKeyShortcut(int keyCode. KeyEvent event); 当 一 个 键盘 快捷 键 事件 发 
生 时 触发 该 方法 。 
æ boolean onKeyUp(int keyCode. KeyEvent event): 当 用 户 在 该 组 件 上 松 开 某 个 按键 
时 触发 该 方法 。 
4 boolean onTouchEvent(int keyCode，KeyEvent event): 当 用 户 在 该 组 件 上 触发 触 
摸 屏 事 件 时 触发 该 方法 。 
4 boolean onTrackballEvent(int keyCode. KeyEvent event); 当 用 户 在 该 组 件 上 触发 
轨迹 球 事件 时 触发 该 方法 。 
上 面 的 函数 boolean onTouchEvent(int keyCode, KeyEvent event) JJ Android 添加 触 
摸 屏 事 件 时 需要 重 写 的 方法 。 接 下 来 介绍 Android 的 触摸 屏 事 件 处 理 。 


@.3 触摸 屏 事件 


上 一 节 讲 的 是 Android 键盘 事件 ,本 节 将 介绍 同样 基于 回调 机 制 的 Android 触摸 屏 事 
件 。 本 节 的 例子 实现 在 Android 设备 屏幕 上 描绘 一 个 红色 的 小 圆 球 ,这 个 小 圆 球 随 着 手指 
在 屏幕 上 的 移动 而 移动 。 


package cn. edu. hstc. touchevent. activity; 


您 刚刚 按 下 了 返回 键 


2.2 响应 键盘 事件 
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import android. content. Context; 
import android. graphics. Canvas; 
import android. graphics. Color; 
import android. graphics. Paint; 
import android. util. AttributeSet; 
import android. view. MotionEvent; 


import android. view. View; 


public class DrawView extends View { 
public float currentX = 40; 
public float currentY = 50; 


public DrawView(Context context, AttributeSet atts) { 
super(context, atts); 


} 


GOverride 
protected void onDraw(Canvas canvas) ( 
super. onDraw(canvas) ; 
Paint p = new Paint(); 
p. setColor(Color. RED); 
canvas.drawCircle(currentX, currentY, 15, p); 


) 


(QOverride 

public boolean onTouchEvent(MotionEvent event) ( 
this.currentX - event.getX(); 
this.currentY - event.getY(); 
// 通 知 组 件 重 绘 
this. invalidate(); 
// 返 回 true 表明 处 理 方法 已 经 处 理 该 事件 


return true; 


代码 文件 : codes V 02 \ 2. 3 \ TouchEvent \ src V cn \ edu \ hstc V touchevent V activity V 

DrawView. java 

上 面 的 程序 自 定义 了 一 个 View 类 , 重 写 了 View 组 件 的 onTouchEvent MotionEvent 
event) 方 法 ,使 该 组 件 能 够 处 理 触 摸 屏 事件 。 本 例 的 onTouchEvent 方法 中 获取 了 当前 手指 
的 xy 坐标 ,然后 在 当前 位 置 上 用 该 View 重 绘 小 球 。 

MotionEvent 是 用 于 处 理 运 动 事件 的 类 ,这 个 类 可 以 获取 动作 的 类 型 坐标。 在 
Android 2. 0 版 本 之 后 .MotionEvent 中 还 包含 了 多 点 触摸 的 信息 , 当 有 多 个 触 点 同时 起 作 
用 的 时 候 , 可 以 获得 触 点 的 数目 和 每 一 个 触 点 的 坐标 。 

接 下 来 就 是 直接 在 界面 中 使 用 该 View 组 件 了 。 

< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android:layout width= "match parent" 
android:layout height = "match parent" 
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android:background = "@color/azure" Sm: 


andrcidcorientation- "vertical" > 


< cn. edu. hstc. touchevent. activity. DrawView 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:orientation = "vertical" /» 


«/LinearLayout > 
代码 文件 : codesVO2V 2. 3VTouchEvent V resV 

layoutVactivity main. xml 

接 下 来 在 Activity 类 中 无 须 为 这 个 View 绑 定 任何 
事件 监听 器 ,因为 这 个 View 自己 就 可 以 处 理 它 的 触摸 
屏 事件 了 。 运 行 效果 如 图 2.3 所 示 。 

通过 为 View 提供 事件 处 理 的 回调 方法 ,可 以 很 好 
地 将 时 间 处 理 方法 封装 在 View 内 部 ,从 而 提高 程序 的 
内 聚 性 。 

基于 回调 的 事件 处 理 更 适合 那 种 事件 处 理 逻 辑 比 
较 固定 的 View。 


@.4 Handler 消息 传递 机 制 


假如 你 的 应 用 需要 联网 读 取 数据 ,这 是 个 比较 耗 时 的 操作 ,你 不 能 把 这 些 耗 时 的 操作 放 
在 主线 程 里 ,因为 这 样 会 出 现 界面 假死 现象 ,所 以 必须 把 这 些 耗 时 的 操作 放 在 子 线程 中 。 但 
由 于 子 线程 又 涉及 UI 的 更 新 操作 ,而 UI 必须 由 主线 程 访 问 。 这 时 ,接收 子 线程 发 送 过 来 
的 数据 ,并 配合 主线 程 更 新 UI 的 Handler 便 出 现 了 。 本 节 将 介绍 Handler 的 消息 传递 
机 制 。 





图 2.3 跟随 手指 的 小 球 


2.4.1 认识 Handler 


对 于 Handler, 它 的 主要 任务 就 是 接收 从 子 线程 传递 过 来 的 数据 、 消 息 , 并 在 主线 程 中 
处 理 获取 到 的 消息 。 

Handler 运行 在 主线 程 中 , 它 与 子 线程 通过 Message 对 象 来 传递 数据 。 分 两 步 : FR 
程 通过 sendMessage() 方 法 传递 Message 对 象 ,里 面包 含 数 据 ; 主线 程 中 的 Handler 接收 
数据 ,并 配合 主线 程 更 新 UL 

Handler 是 通过 回调 的 方式 来 处 理子 线程 传递 过 来 的 数据 的 。 开 发 者 只 要 重 写 
Handler 类 中 的 处 理 消 息 的 方法 , 当 子 线程 中 的 消息 被 发 送 时 ,Handler 类 中 处 理 消息 的 方 
法 将 被 自动 调用 。 

用 于 发 送 、 处 理 消息 的 方法 如 下 : 

4t void handleMessage( Message msg) 一 一 处 理 消息 的 方法 。 该 方法 通常 用 于 被 重 写 。 

æ final boolean hasMessages(int what) 一 一 检查 消息 队列 中 是 否 包 含 what 属性 为 指 
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定 值 的 消息 。 


final boolean hasMessages(int what. Object object) 一 一 检查 消息 队列 中 是 否 包 含 
what 属性 为 指定 值 且 object 属性 为 指定 对 象 的 消息 。 

e ST «m Message obtainMessage() 一 一 获取 消息 。 

æ sendEmptyMessage(int what) 一 一 发 送 空 消息 。 

final boolean sendEmptyMessageDelayed(int what. long delayMillis) 一 一 指定 多 少 
毫秒 之 后 发 送 空 消息 。 

æ final boolean sendMessage( Message msg) 一 一 立即 发 送 消息 。 

æ final boolean sendMessageDelayed( Message msg. long delayMillis) 一 一 指定 多 少 毫 
秒 之 后 发 送 消息 。 


2.4.2 使 用 Handler 





上 节 已 经 简单 介绍 了 Android Handler 的 作用 以 及 Handler 类 中 常用 的 回调 方法 。 本 
节 将 通过 一 个 简单 的 例子 来 进一步 学 习 Android Handler 的 使 用 。 


« LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:background = "(2 color/azure" 
android:orientation = "vertical" > 


« EditText 
android:id- "@ + id/show" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:hint = " 触 碰 读 取 SD 卡 中 的 文件 内 容 " 
android:lines = "10" /> 


</LinearLayout > 
代码 文件 : codes\02\2. 4\HandlerDemo\res\ layout\activity_main. xml 


上 面 的 XML 界面 文件 很 简单 ,只 是 在 一 个 空白 的 界面 布局 中 添加 了 一 个 文本 框 ,用 于 
显示 从 SD 卡 里 读 取 到 的 内 容 。 


package cn. edu. hstc. handlerdemo. activity; 


import cn. edu. hstc. handlerdemo. util. FileHelper; 
import android. app. Activity; 

import android. os. Bundle; 

import android. os. Handler; 

import android. os. Message; 

import android. view. MotionEvent; 

import android. view. View; 

import android. view. View. OnTouchListener; 
import android. widget. EditText; 


public class MainActivity extends Activity ( 
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private EditText show; 
private FileHelper fileHelper = new FileHelper(); 
private String result; 


(QOverride 
protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate( savedInstanceState); 
setContentView(R. layout. activity main); 
show = (EditText) findViewById(R. id. show) ; 
// B 5E X. Handler 
final Handler handler - new Handler() ( 
(2Override 
public void handleMessage(Message msg) ( 
if (msg. what == 0x123) ( 
// 当 消息 表示 为 0x123 时 ,将 消息 中 的 数据 填写 到 EditText 中 
Show. setText(msg. obj. toString()); 


) 
}; 


show. setOnTouchListener(new OnTouchListener() { 
@Override 
public boolean onTouch(View arg0, MotionEvent argl) ( 
new Thread(new Runnable() ( 
@Override 
public void run() ( 
result = fileHelper.readSDFile("test. txt"); 
Message msg = new Message(); 
msg.what - 0x123; 
msg.obj = result; 
handler. sendMessage(msg) ; 
) 
]).start(); 
return false; 


Di 
代码 文件 : codes V O2 V 2. 3 \ HandlerDemo \ src V cn V edu V hstc \ handlerdemo V activity V 
MainActivity. java 


package cn. edu. hstc. handlerdemo. util; 


import java. io.File; 
import java. io. FileInputStream; 


import org. apache. http. util. EncodingUtils; 


import android. os. Environment; 


public class FileHelper { 
//SD 卡 的 路 径 
private String SDPATH; 


public FileHelper() { 
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SDPATH = Environment.getExternalStorageDirectory().getPath(); 


} 


public String readSDFile(String fileName) { 


File file = new File(SDPATH + "//" + fileName); 


String res - 


try { 


FileInputStream fis = new FileInputStream(file); 


int length - fis.available(); 
byte[] buffer = new byte[length]; 


fis.read(buffer); 


res = EncodingUtils.getString(buffer, "UTF - 8"); 


fis.close(); 
) catch (Exception e) ( 
e. printStackTrace(); 
) 


return res; 


) 


代码 文件 : codes V 02 \ 2. 3X HandlerDemo \ src V cn \ edu V hstc V handlerdemo V activity V 


FileHelper. java 


上 面 的 代码 中 ,定义 了 一 个 Handler 25. 3E 75 f 
handleMessage 回调 方法 。 该 方法 实现 当 接 收 到 的 消 
息 标 识 为 0x123 时 ,将 接收 到 的 消息 作为 界面 中 的 
EditText 的 显示 内 容 。 这 里 使 用 的 是 回调 机 制 , D F 
线程 发 送 消息 时 ,handleMessage 方法 将 会 被 自动 回调 。 
之 所 以 在 handleMessage 方法 中 能 够 访问 Activity 中 的 
组 件 , 是 因为 该 方法 是 在 主线 程 中 被 调用 的 。 

程序 中 为 EditText 注册 了 触摸 屏 监 听 器 ,该 监听 
器 实现 启动 一 条 子 线程 ,用 于 读 取 SDCard 中 的 aa. txt 
文本 并 将 读 取 到 的 内 容 封 装 在 消息 对 象 中 ,如 代码 行 
msg. obj = res。 然 后 通过 handler. sendMessage(msg) 发 
送 消息 , 此 处 使 用 的 handler 即 为 之 前 所 定义 的 
Handler 类 的 对 象 。 这 样 ,在 该 线程 中 所 发 送 的 消息 将 
会 被 这 个 handler 所 接收 。 

运行 效果 如 图 2.4 所 示 。 


BMS 2:45 


GELEITET] 


这 是 一 个 关于 Android Handler 的 故 


事 
故事 很 长 ， 希 望 读者 能 耐心 读 完 
厚 德 载 物 ， 加 油 





图 2.4 借助 Handler 更 新 UI 
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8.5 本 章 小 结 


本 章 的 学 习 重 点 是 掌握 Android 的 两 种 事件 处 理 机 制 : 基于 回调 的 事件 处 理 和 基于 监 
听 的 事件 处 理 。 对 于 基于 监听 的 事件 处 理 模式 来 说 ,需要 读者 了 解 的 有 五 种 不 同 的 响应 方 
法 : 使 用 匿名 内 部 类 作为 事件 监听 器 类 ; 使 用 内 部 类 作为 事件 监听 器 类 ; 使 用 外 部 类 作为 
事件 监听 器 类 ; 使 用 Activity 类 本 身 作为 事件 监听 器 类 ; 将 事件 处 理 方法 绑 定 到 界面 文件 
中 。 对 于 基于 回调 的 事件 处 理 模 式 来 说 ,开发 者 需要 掌握 不 同事 件 对 应 的 回调 方法 。 本 章 
介绍 了 键盘 事件 处 理 、 触 摸 屏 事 件 处 理 以 及 使 用 Handler 消息 传递 机 制 处 理 耗 时 事件 。 这 
三 种 事件 处 理 都 是 基于 Android 回调 机 制 。 学 习 本 章 后 ,相信 读者 已 经 了 解 了 各 种 常见 的 
Android 事件 处 理 方法 。 





Android 基 本 界面 组 件 | 


我 们 判定 一 个 应 用 的 好 与 坏 , 用 户 体验 起 着 至 关 重 要 的 作用 ,而 一 个 具有 和 良好 的 用 户 体 
验 的 应 用 也 必 将 是 一 个 具有 友好 的 图 形 用 户 界面 的 应 用 ,和 否则 将 很 难 吸 引 最 终 用 户 。 实 际 
上 ,很 多 优秀 的 、 市 面 上 流行 的 Android 软件 ,首先 都 会 给 用 户 提 供 友好 的 图 形 用 户 界 面 ,这 
样 的 程序 才 会 被 接受 而 流行 起 来 。 

Android 提供 了 大 量 功 能 丰富 的 UI 组件, 开发 者 只 要 按 一 定 规律 把 这 些 UI 组 件 搭建 
在 一 起 就 可 以 开发 出 优秀 的 图 形 用 户 界 面 。Android 界面 开发 是 Android 应 用 开发 的 基 
础 ,也 是 Android 开发 非常 重要 的 组 成 部 分 。 


6.1 Android 五 大 布局 管理 器 
Ls 


Android 的 界面 是 由 布局 和 组 件 协同 完成 的 ,布局 好 比 是 建筑 里 的 框架 ,而 组 件 则 相当 
于 建筑 里 的 砖 瓦 。 组 件 按照 布局 的 要 求 依次 排列 ,就 组 成 了 用 户 所 看 见 的 界面 。 通 过 使 用 
布局 管理 器 ,Android 应 用 的 界面 组 件 可 在 不 同 分 辩 率 的 手机 上 得 到 良好 的 控制 。 因 此 通 
常 推荐 使 用 布局 管理 器 来 管理 组 件 的 分 布 , 大 小 ,而 不 是 设置 组 件 的 位 置 和 大 小 。 如 果 在 程 
序 中 设置 了 组 件 的 大 小 和 位 置 ,那么 这 个 应 用 一 般 只 能 运行 于 特定 的 分 辩 率 的 手机 ,不 能 做 
到 手机 自 适应 。 而 Android 布局 管理 器 可 以 根据 运行 的 手机 来 调整 组 件 的 大 小 与 位 置 ,我 
们 只 需 为 容器 选择 合适 的 布局 管理 器 。 

Android 的 五 大 布局 分 别 是 LinearLayout (线性 布局 )、FrameLayout ( 单 帧 布局 )、 
RelativeLayout( 相 对 布局 )、AbsoluteLayout( 绝 对 布局 ) 和 TableLayout( 表 格 布局 )。 


3.1.1 线性 布局 


线性 布局 管理 器 在 XML 文件 中 为 一 个 LinearLayout 标签 ,在 该 标签 下 的 子 标签 所 代 
表 的 组 件 将 会 按照 从 左 到 右 或 从 上 到 下 的 顺序 依次 排列 起 来 。LinearLayout 通过 设置 
android :orientation 属性 来 控制 容器 里 各 组 件 的 排列 方向 ,可 横向 排列 , 亦 可 纵向 排列 。 

提示 : 当 组 件 太 多 时 ,排列 到 手机 屏幕 的 尽头 时 ,Android 线性 布局 不 会 自动 将 余下 的 
组 件 换 到 下 一 行 显示 , 剩 下 的 组 件 将 看 不 到 。 

LinearLayout 中 的 子 元 素 有 一 个 重要 的 属性 是 android:layout_weight, 它 用 于 描述 该 
子 元 素 在 该 LinearLayout 中 的 权重 。 如 一 行 只 有 一 个 文本 框 ,那么 该 属性 的 默认 值 就 为 0。 
如 果 一 行 中 有 两 个 等 长 的 文本 框 ,那么 它们 该 属性 的 值 可 以 同 为 1 。 如 果 想 让 同一 行 的 两 
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个 文本 框 其 中 的 一 个 长 占 三 分 之 二 , 另 一 个 长 占 三 分 之 一 ,那么 它们 该 属性 的 值 就 为 1 和 
2。 总 之 记 住 ,android:layout_weight 的 数值 越 小 ,权重 越 高 。 
如 下 XML 代码 文件 定义 了 一 个 线性 布局 。 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:gravity = "bottom|center horizontal" 
android:orientation = "vertical" > 


« Button 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "@string/first" > 


« Button 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: text = "(Qstring/second" > 


< Button 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "(3string/third" > 


«/LinearLayout > 
代码 文件 : codes V03V3. 1NLineayLayoutDemoVresMlayoutVactivity main. xml 
上 面 的 布局 文件 定义 了 一 个 简单 的 线性 布局 ,布局 中 的 三 个 按钮 从 上 到 下 垂直 排列 ,并 
且 整 体 底部 居中 。 运 行 上 面 的 程序 ,可 以 看 到 如 图 3. 1 所 示 的 界面 。 


dame 132ww 
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图 3.1 垂直 排列 ,底部 居中 
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如 果 把 上 面 代码 文件 中 的 android: gravity 的 属性 值 改 为 center, 则 运行 结果 变 为 如 
图 3.2 所 示 。 

如 果 要 将 这 三 个 按钮 设置 成 从 左 到 右 顺 序 排列 ,那么 只 要 将 android: orientation 属性 
值 改 为 horizontal 即 可 。 运 行 结 果 如 图 3. 3 所 示 。 


game 1:37 gn 302 
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图 3.2 垂直 排列 ,整体 居中 图 3.3 横向 排列 ,整体 居中 


3.1.2 表格 布局 


表格 布局 在 XML 代码 文件 中 用 一 个 TableLayout 表示 ,可 以 在 一 个 Activity 中 添加 
多 行 ,每 一 行 又 可 以 设置 多 个 列 ,横竖 交叉 ,形成 表格 ,所 以 叫 表 格 布局 。 

表格 布局 用 添加 一 个 TableRow 标签 来 表示 新 增加 一 行 ,然后 在 这 个 TableRow 中 添 
加 一 个 组 件 ,表示 该 TableRow 新 增 了 一 列 。 列 的 宽度 由 该 列 中 最 宽 的 那个 单元 格 决定 , 整 
个 TableLayout 的 宽度 则 取决 于 父 容器 的 宽度 (如 手机 屏幕 宽度 ) 。 

如 果 直 接 向 TableLayout 添加 组 件 ,那么 这 个 组 件 就 直接 占用 一 行 。 

在 表格 布局 中 ,可 以 为 单元 格 设置 如 下 属性 。 

android : collapseColumns — "1" ,隐藏 该 TableLayout 里 的 TableRow 的 列 1, 即 第 2 列 
(从 0 开始 算 起 ) ,车 有 多 列 要 隐藏 , 则 列 数 之 间 用 “,” 隔 开 。 

android:shrinkColumns 二 "1", 将 TableLayout 里 的 TableRow 的 列 1 设置 收缩 , 即 第 
2 列 ( 从 0 开始 算 起 ) ,车 有 多 列 要 收缩 , 则 列 数 之 间 用 “ ,” 隔 开 。 

android:stretchColumns 一 "1" ,将 TableLayout 里 的 TableRow 的 列 1 设置 伸张 , 即 第 
2 列 ( 从 0 开始 算 起 ) , 若 有 多 列 要 伸张 , 则 列 数 之 间 用 *,” 隔 开 。 
注意 : TableLayout 的 行 数 由 开发 人 员 制 定 , 即 有 多 少 个 TableRow 对 象 (或 view 控 
件 ) ,就 有 多 少 行 。 列 的 宽度 : 由 该 列 中 最 宽 的 单元 格 决定 ,整个 表格 布局 的 宽度 取决 于 父 
容器 的 宽度 (默认 是 占 满 父 容器 本 身 ) 。 如 第 一 个 TableRow 含 2 个 控件 ,第 二 个 TableRow 
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含 3 个 控件 ,那么 该 TableLayout 的 列 数 为 3 。 
如 下 XML 代码 文件 定义 了 一 个 TableLayout。 


< TableLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 
android:background = "(2 color/azure" 
android:stretchColumns - "1" 
android:padding = "20dip"» 


< TableRow 

android:layout width = "fill parent" 

android:layout height = "wrap content" 

android:layout marginTop = "10dip"> 

« TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "right|center vertical" 
android:textColor = "(Qcolor/black" 
android:text = "JH P & : "/> 

< EditText 
android: layout_width = "wrap content" 
android: layout_height = "wrap_content" 
android: background = "@drawable/shurukuang" 
android:hint = "请 输入 用 户 名 "/> 


</TableRow> 

< TableRow 
android:layout width= "fill parent" 
android:layout height = "wrap content" 





android:layout marginTop = "5dip"> 

< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "right|center vertical" 
android:textColor = "(Gcolor/black" 
android: text = "密码 : "/> 

< EditText 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:background = "(2 drawable/shurukuang" 
android: inputType = "textPassword" 
android:hint = "请 设 定 密码 "/> 

</TableRow> 


< TableRow 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout marginTop = "5dip"> 
< LinearLayout 
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android:layout width- "wrap content" 

android:layout height = "wrap content"/» 
< LinearLayout 

android:layout width- "wrap content" 


android:layout height = "wrap content" bt "m ID AGES 
android:layout gravity = "right" 
« Button 

android:layout width = "60dip" - 

android:layout height = "40dip" 用 户 名 : 请 输入 用 户 名 


[. T PPP 


android: background = "(2 drawable/bt2" 
android: text = "登录 "人 > 
< Button 登录 注册 
android:layout width = "60dip" sd 
android:layout height = "40dip" 
android: background = "(à drawable/bt2" 
android:layout marginLeft = "5dip" 
android: text = "注册 "/> 
</LinearLayout > 
</TableRow> 


TUV 


</TableLayout > 
代码 文件 : codes\03\3. 1\TableLayoutDemo\ 
res\layout\activity main. xml 


运行 结果 如 图 3.4 所 示 。 
3.1.3 相对 布局 


Android 相对 布局 在 XML 文件 的 元 素 为 RealativeLayout ,在 相对 布局 中 ,一 个 控件 的 
位 置 决定 于 它 和 其 他 控件 的 关系 。 这 样 做 的 好 处 是 比较 灵活 ,缺点 是 比较 复杂 。 接 下 来 将 
相对 布局 常用 的 属性 分 成 四 组 进行 讲解 。 

表 3. 1 给 出 了 四 个 属性 设置 控件 之 间 的 关系 和 位 置 。 





图 3.4 定义 TableLayout 








表 3.1 位 置 属性 
属性 名 称 Hood & È 
android:layout above 将 该 控件 置 于 给 定 ID 控件 之 上 
i bow 将 该 控件 置 于 给 定 ID 控件 之 下 人 





Il: android: 1 bove 一 " 
android.layout toLeftOf 。 | 将 该 控件 置 于 给 定 ID 控件 的 左边 : j ana leye 
id/entry 


android:layout toRightOf 将 该 控件 置 于 给 定 ID 控件 的 右边 











上 面 四 个 属性 并 没有 设置 各 个 控件 之 间 是 否 对 齐 。 例 如 使 用 android:layout_below 属 
性 将 B 控件 置 于 A 控件 之 下 ,那么 可 能 出 现 的 情况 是 B 控件 确实 在 A 控件 之 下 ,但 了 控件 
JR A 控件 并 没有 对 齐 , 男 一 种 情况 是 B 控件 在 A 控件 之 下 的 同时 两 控件 对 齐 。 

如 下 定义 的 XML 界面 文件 ,将 B 控 件 置 于 A 控件 之 下 ,但 两 者 并 没有 对 齐 。 





< RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 
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android:padding - "10dip" 
android:background = "(Zcolor/azure"» 


« Button 
android:layout width- "wrap content" 
android:layout height = "50dip" 
android:text = "我 是 A 控件 " 


android:layout alignParentRight = "true" 


android:background = "(2 drawable/bt2" 
android:id- "(à + id/btn A"/» 


« Button 
android:layout width = "wrap content" 
android:layout height - "50dip" 
android: text = "我 是 B 控 件 " 
android:background = "@drawable/bt2" 
android:layout below = "@id/btn_A"/> 


</RelativeLayout > 


代码 文件 : codes\03\3. 1\RelativeLayoutDemo\res\layout\activity_main. xml 


运行 效果 如 图 3. 5 所 示 。 


将 上 面 代码 文件 中 的 android:layout_alignParentRight= "true" 去 掉 ,B 控件 与 A 控件 


将 对 齐 ,运行 效果 如 图 3. 6 BER 
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RelativeLayoutDemo 





图 3.5 B 控 件 与 A 控件 没 对 齐 


mne: 
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图 3.6 BFS A 控件 对 齐 


如 表 3. 2 所 示 的 五 个 属性 ,设置 的 是 控件 与 控件 之 间 的 对 齐 方式 。 


表 3.2 控件 之 间 对 齐 方式 属性 
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属性 名 称 di xk 备 注 

二 ER 将 读 控 件 的 基线 (baseline) 与 给 

E 5E ID 控件 的 基线 对 齐 
android:layout_alignTop 将 该 控件 的 顶部 与 给 定 D 控件 

E 的 顶部 对 齐 该 属性 值 为 某 个 控件 的 ID 
android:layout_alignBottom 将 该 控件 的 底部 与 给 定 四 控件 | 如 ; 

z 的 底部 对 齐 android:layout_alignTop="@id/ 
android; layout, alignLeft SEORSUM IN Sue 

E 控件 的 左边 边缘 对 齐 
android:layout_alignRight 将 该 控件 的 右边 边缘 与 给 定 TD 

ss 控件 的 右边 边缘 对 齐 


给 代码 文件 : codes\O3\3. 1\RelativeLayoutDemo\res\layout\activity_main. xml 中 的 
B 控件 加 上 android:layout_alignRight="@id/btn_A" 这 样 一 句 代 码 , 即 可 控制 A 控件 跟 B 
控件 的 右边 缘 对 齐 。 和 运行 效果 如 图 3.7 所 示 。 
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图 3.7 B 控 件 跟 A 控件 的 右边 边缘 对 齐 


K 3.3 给 出 了 四 个 属性 设置 控件 与 父 控件 之 间 对 齐 的 方式 。 
表 3.3 控件 与 父 控件 之 间 对 齐 的 方式 属性 


属性 名 称 


描 3x 


€ È 





android:layout_alignParentTop 


将 该 控件 的 顶部 与 父 控件 的 项 部 对 齐 





android: layout_alignParentBottom 


将 该 控件 的 顶部 与 父 控件 的 底部 对 齐 


可 选 值 为 true 和 





android: layout_alignParentLeft 


将 该 控件 的 顶部 与 父 控件 的 左边 边缘 对 齐 


false 





android: layout_alignParentRight 





将 该 控件 的 顶部 与 父 控件 的 右边 边缘 对 齐 
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如 下 面 的 XML 代码 文件 ,将 A 控件 与 B 控 件 上 下 置 放 ,并 且 B 控件 右边 边缘 与 父 控 
件 对 齐 。 


< RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android: layout width= "match parent" 
android:layout height = "match parent" am 4 23724 


android: padding= "10dip 


android: background = "@color/azure"> 





< Button 
android:layout width = "wrap content" 
android:layout height = "50dip" 
android:text = "我 是 A 控件 " 
android:background = "@drawable/bt2" 
android:id= "(à + id/btn A"/» 





< Button 
android:layout width = "wrap content" 
android:layout height - "50dip" 
android:text = "我 是 B 控 件 " 
android:background = "@drawable/bt2" 
android:layout below = "@ id/btn_A" 
android:layout alignParentRight = "true" /> 


</RelativeLayout > 图 3.8 B 控 件 右边 边缘 跟 父 控件 对 齐 


运行 效果 如 图 3. 8 所 示 。 
表 3.4 给 出 了 三 个 属性 控制 控件 的 方向 。 


X34 控件 方向 属性 

















属性 名 称 do 3 备 È 
android: layout, centerHorizontal 将 该 控件 左右 居中 
android:layout_centerVertical 将 该 控件 上 下 居中 可 选 值 为 true 和 false 
android:layout_centerInParent 将 该 控件 上 下 左右 居中 


下 面 的 XML 代码 文件 中 ,了 B 控件 在 父 控件 上 下 左右 方向 居中 。 


<RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout_width = "match parent" 
android:layout height = "match parent" 
android:padding = "10dip" 
android:background = "(Zcolor/azure"» 


« Button 
android:layout width- "wrap content" 
android:layout height = "50dip" 
android:text = "我 是 A 控件 " 
android:background = "(2 drawable/bt2" 
android:id- "(2 + id/btn A"/» 


< Button 
android:layout width = "wrap content" 
android:layout height = "50dip" 
android:text = "我 是 B 控 件 " 
android:background = "@drawable/bt2" 
android:layout centerInParent = "true"/> 


</RelativeLayout > 


运行 效果 如 图 3.9 所 示 。 
3.1.4 绝对 布局 


绝对 布局 在 Android 中 用 AbsoluteLayout 表示 。 
绝对 布局 中 的 组 件 大 小 需要 开发 人 员 自 己 来 控制 ,甚至 
组 件 的 位 置 都 需要 开发 人 员 通 过 坐标 来 控制 。 

在 相对 布局 中 ,通过 设置 每 个 控件 的 layout_x 以 及 
layout. y 属性 来 设置 控件 的 x 坐标 和 y 坐标 ,以 此 来 控 
制 控 件 的 位 置 。 
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图 3.9 B 控 件 在 父 控件 居中 


注意 : 使 用 绝对 布局 的 方法 在 直接 拖 控 件 的 时 候 显得 比较 方便 ,但 是 不 利于 程序 的 后 


期 调整 ,而且 也 不 能 做 到 界面 的 自 适应 性 ,很 难 做 到 兼顾 不 同 手机 的 屏幕 大 小 以 及 分 辩 率 。 
如 下 XML 代码 文件 中 ,用 绝对 布局 定义 了 一 个 登录 界面 。 


< RbsoluteLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android:layout_width = "match parent" 
android:layout height = "match parent" 
android:background = "(d)color/azure"» 


< TextView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android:text = "HP: " 
android:layout x= "20dip" 
android:layout y = "20dip"/» 


< EditText 
android:layout x= "80dip" 
android:layout y= "15dip" 
android:layout width = "wrap content" 
android:width = "200px" 
android:layout height = "wrap content" 


android:background = "(2 drawable/shurukuang" /> 


« TextView 
android:layout x= "20dip" 
android:layout y= "80dip" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
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android:text- "4j W: "/> 


< EditText 
android:layout x = "80dip" 
android:layout y= "75dip" 
android:layout width = "wrap content" 
android:width = "200px" 
android:layout height = "wrap content" 
android:password = "true" 
android:background = "(2 drawable/shurukuang" /» 


« Button 
android:layout x= "130dip" 
android:layout y= "135dip" 
android:layout width = "wrap content" 
android:layout height = "40dip" 
android:text- "XR — o" 
android:background = "(à)drawable/bt2" /» 


«/AbsoluteLayout > 
代码 文件 : codes\03\3. 1MAbsoluteLayoutDemoVresMlayoutVactivity main.xml 
运行 效果 如 图 3. 10 Bros 。 Qnm 3:0814 
上 面 在 设置 组 件 的 x 坐标 、y 坐标 中 用 了 android: 
layout_x 一 "20dip" 这 样 的 语句 ,dip 是 一 个 距离 单位 。 mrs: o 
Android 支持 如 下 常用 的 距离 单位 。 
apx: 像素 ,每 个 像素 对 应 屏幕 中 的 一 个 点 。 za: 
adip R dp: 设备 独立 像素 ,一 种 基于 屏幕 密度 的 
抽象 单位 。1dip 二 1px, 但 随 着 屏幕 密度 的 改变 ， EE 
dip 与 px 的 换算 会 发 生 改变 。 
sp: 比例 像素 ,主要 处 理 字体 的 大 小 。 


3.1.5 帧 布局 


FrameLayout 帧 布局 在 屏幕 上 开辟 出 一 块 区 域 , 在 
这 块 区 域 中 可 以 添加 多 个 子 控件 ,但 是 所 有 的 子 控件 
都 被 对 齐 到 屏幕 的 左上 和 角 。 帧 布局 的 大 小 由 子 控件 中 
尺寸 最 大 的 那个 子 控件 来 决定 。 如 果子 控件 一 样 大 ， 图 3.10 绝对 布局 
那么 同一 时 刻 只 能 看 到 最 上 面 的 子 控件 。 
在 帧 布局 中 , 子 控件 是 通过 栈 来 绘制 的 ,所 以 后 添加 的 子 控件 会 被 控制 在 上 层 。 
如 下 XML 代码 文件 中 ,在 一 个 帧 布局 中 定义 了 三 个 线性 布局 , 层 层 相 琶 。 
< FrameLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 


android:layout height = "match parent" 
android:background = "@color/azure"> 


第 3 章 ，Android 基 本 界面 组 件 (s) 


< LinearLayout BM E 7:58am 
android:layout_width = "100dip" FrameLayoutDemo 


android:layout height = "100dip" 
android:background = "@color/red" /> 





< LinearLayout 
android:layout width = "80dip" 
android:layout height = "80dip" 
android:background = "(2 color/seagreen" /» 


< LinearLayout 
android:layout width = "60dip" 
android:layout height = "60dip" 
android:background = "(2 color/yellow"/» 


«/Framelayout > 
代码 文件 : codes\03\3. 1VFrameLayoutDemoV 
res\layout\activity_main. xml 


运行 效果 如 图 3. 11 所 示 。 图 3.11 帆布 局 


8.2. Android 基本 界面 组 件 
3.2 


实际 上 ,无 论 是 看 起 来 多 么 美观 的 操作 界面 ,都 是 由 一 个 又 一 个 的 界面 组 件 堆 砌 而 成 
的 ,这 些 组 件 就 放 在 一 个 容器 (ViewGroup) 里 面 。 而 单独 掌握 这 些 基 本 界面 组 件 也 是 学 习 
Android 编程 的 一 个 必 不 可 少 的 环节 。 接 下 来 将 重点 介绍 Android 的 基本 界面 组 件 。 


3.2.1 文本 框 和 编辑 框 


文本 框 Candroid. widget. TextView) 是 android. view. View 的 直接 子 类 ,同时 也 是 
Button, \CheckedTextView , Chronometer, DigitalClock , Edit Text 的 直接 父 类 , 它 的 间接 子 
类 是 AutoCompleteTextView 、CheckBox CompoundButton , ExtractEdit Text, MultiAuto- 
CompleteText View , RadioButton, ToggleButton, 

Text View 的 作用 就 是 在 界面 上 显示 文本 ,但 是 它 没有 文本 编辑 功能 ,如 果 开 发 者 需要 
一 个 可 以 编辑 内 容 的 文本 框 ,那么 可 以 使 用 TextView 的 子 类 EditText( 编 辑 框 ), EditText 
允许 用 户 在 文本 框 中 编辑 内 容 。 

TextView 提供 大 量 的 XML 属性 ,这 些 属性 大 部 分 不 仅 适用 于 TextView, 还 适用 于 
EditText。 表 3.5 显示 了 TextView 支持 的 属性 及 其 描述 。 


表 3.5 TextView 支持 的 属性 及 其 描述 
属性 名 称 描 x 


设置 是 否 当 文本 为 URL 链接 /email/ 电 话 号 码 /map 时 ,文本 显示 为 可 单 
单 击 的 链接 。 可 选 值 为 none/web/email/phone/map/all 

如 果 设 置 ,将 自动 执行 输入 值 的 拼写 纠正 。 此 处 无 效果 ,在 显示 输入 法 并 
输入 的 时 候 起 作用 





android:autoLink 





android:autoText 
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续 表 
属性 名 称 描 述 

指定 getText() 方 式 取得 的 文本 类 别 。 选 项 editable 类 似 于 StringBuilder 

android:bufferType 可 追加 字符 ,也 就 是 说 ,在 getText 后 可 调用 append 方法 设置 文本 内 容 。 
spannable 则 可 在 给 定 的 字符 区 域 使 用 样式 

EEE A 设置 英文 字母 大 写 类 型 。 此 处 无 效果 ,需要 弹出 输入 法 才能 看 得 到 ,参见 
EditText 此 属性 说 明 

android :cursorVisible 设 定 光 标 为 显示 /隐藏 ,默认 显示 

android: digits 设置 允许 输入 哪些 字符 。 如 “1234567890. 十 一 * //6NnO" 

PER S diswableBodom 在 text 的 下 方 输出 一 个 drawable, 如 图 片 。 如 果 指 定 一 个 颜色 ,会 把 text 

的 背景 设 为 该 颜色 ,并且 同时 和 background 使 用 时 覆盖 后 者 

android:drawableLeft 在 text 的 左边 输出 一 个 drawable 
设置 text 与 drawable( 图 片 ) 的 间隔 , 与 drawableLeft、drawableRight、 

android:drawablePadding drawableTop .drawableBottom 一 起 使 用 ,可 设置 为 负数 ,单独 使 用 没有 
效果 

android:drawableRight 在 text 的 右边 输出 一 个 drawable 

android:drawableTop 在 text 的 正 上 方 输出 一 个 drawable 

android; editable 设置 是 否 可 编辑 

android ; editorExtras 设置 文本 的 额外 的 输入 数据 ,在 EditView 中 再 讨论 
设置 当 文 字 过 长 时 ,该 控件 该 如 何 显示 。 有 如 下 值 设置 : start 一 一 省 略 

android:ellipsize 号 显示 在 开头 ;end 一 一 省 略 号 显示 在 结尾 ; middle 省 略 号 显示 在 中 
间 ; marquee 以 跑马 灯 的 方式 显示 (动画 横向 移动 ) 

android :freezesText 设置 保存 文本 的 内 容 以 及 光标 的 位 置 

android: gravity 设置 文本 位 置 , 如 设置 成 center, 则 文本 将 居中 显示 

adeo Text 为 空 时 显示 的 文字 提示 信息 ,可 通过 textColorHint 设置 提示 信息 的 
颜色 。 此 属性 在 EditView 中 使 用 ,但 是 这 里 也 可 以 用 
附加 功能 ,设置 右 下 角 IME 动作 与 编辑 框 相关 的 动作 ,如 actionDone 右 

android:imeOptions 下 角 将 显示 一 个 “完成 ”而 不 设置 默认 是 一 个 回 车 符号 。 这 个 在 
EditText 中 再 详细 说 明 ,此 处 无 用 

android :imeActionId 设置 IME 动作 ID, 在 EditText 中 再 做 说 明 

android :imeActionLabel 设置 IME 动作 标签 ,在 EditText 中 再 做 说 明 

android:includeFontPadding | 设置 文本 是 否 包 含 顶部 和 底部 额外 空白 ,默认 为 true 

audccid dapetMzthod 为 文本 指定 输入 法 ,需要 完全 限定 名 (完整 的 包 名 )。 例 如 ,com. google. 
android. inputmethod. pinyin, 但 是 这 里 报错 找 不 到 

androidiapatType 设置 文本 的 类 型 ,用 于 帮助 输入 法 显示 合适 的 键盘 类 型 。 在 EditText 中 
再 详细 说 明 ,这 里 无 效果 

android; linksClickable 设置 链接 是 否 单 击 连接 ,即使 设置 了 autoLink 

. . . | 在 ellipsize 指定 marquee 的 情况 下 ,设置 重复 滚动 的 次 数 , 当 设 置 为 
android:marqueeRepeatLimit 


marquee_forever 时 表示 无 限 次 





android: 


ems 


设置 TextView 的 宽度 为 N 个 字符 的 宽度 。 这 里 测试 为 一 个 汉字 字符 宽 
度 ,效果 如 右 : Y 





android; 


一 


maxEms 





设置 TextView 的 宽度 为 最 长 为 N 个 字符 的 宽度 。 与 ems 同时 使 用 时 覆 
盖 ems 选项 
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~ Rege | dB o* 0 
"mm 设置 TextView 的 宽度 为 最 短 为 N 个 字符 的 宽度 。 与 ems 同时 使 用 时 覆 

android:minEms 

盖 ems 选项 
android:maxLength 限制 显示 的 文本 长 度 , 超 出 部 分 不 显示 
android: lines 设置 文本 的 行 数 ,设置 两 行 就 显示 两 行 ,即使 第 二 行 没 有 数据 
android since 设置 文本 的 最 大 显示 行 数 ,与 width 或 者 layout_width 结合 使 用 ,超出 部 

分 自动 换行 ,超出 行 数 将 不 显示 
android:minLines 设置 文本 的 最 小 行 数 ,与 lines 类 似 





android; lineSpacingExtra 设置 行 间距 

android; lineSpacingMultiplier| 设置 行 间距 的 倍数 。 如 1. 2 

如 果 被 设置 , 则 该 TextView 有 一 个 数字 输入 法 。 此 处 无 用 ,设置 后 唯一 
效果 是 TextView 有 单 击 效果 ,此 属性 在 EditText 中 将 详细 说 明 

android: password 以 小 点 “. ”显示 文本 

android:phoneNumber 设置 为 电话 号 码 的 输入 方式 

android:privatelmeOptions | 设置 输入 法 选项 ,此 处 无 用 ,在 EditText 中 将 进一步 讨论 
android:scrollHorizontally 设置 文本 超出 TextView 的 宽度 的 情况 下 ,是否 出 现 横 拉 条 

如 果 文 本 是 可 选择 的 , 则 让 它 获取 焦点 而 不 是 将 光标 移动 到 文本 的 开始 
位 置 或 者 末尾 位 置 。EditText 中 设置 后 无 效果 

指定 文本 阴影 的 颜色 ,需要 与 shadowRadius 一 起 使 用 。 效 








android:numeric 

















android; selectAllOnFocus 





android : shadowColor 














LI 

android: shadowDx 设置 阴影 横向 坐标 开始 位 置 

android:shadowDy 设置 阴影 纵向 坐标 开始 位 置 

EENE TE 设置 阴影 的 半径 。 设 置 为 0. 1 就 变 成 字体 的 颜色 了 ,一 般 设置 为 3.0 的 
效果 比较 好 





设置 单行 显示 。 如 果 和 layout width 一 起 使 用 , 当 文本 不 能 全 部 显示 时 ， 
后 面 用 “…” 来 表示 。 如 android; text 一 "test singleLine " android: 
singleLine 二 "true”android:layout_width 二 "20dp" 将 只 显示 “t…”。 如 果 
不 设置 singleLine 或 者 设置 为 false, 文 本 将 自动 换行 

android : text 设置 显示 文本 

设置 文字 外 观 。 如 “? android: attr/textAppearanceLargeInverse" 3X Hi 5| 
用 的 是 系统 自 带 的 一 个 外 观 ,? 表示 系统 是 否 有 这 种 外 观 , 否 则 使 用 默认 
android :textAppearance 的 外 观 。 可 设置 的 值 如 下 : textAppearanceButton/textAppearanceInverse/ 
textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/ 
textAppearanceMediumlInverse/ text AppearanceSmall/ text AppearanceSmallInverse 


android: singleLine 























android; textColor 设置 文本 颜色 

android; textColorHighlight 被 选中 文字 的 底 色 ,默认 为 蓝 色 

android :textColorHint 设置 提示 信息 文字 的 颜色 ,默认 为 灰色 。 与 hint 一 起 使 用 

android :textColorLink 文字 链接 的 颜色 
设置 文字 缩放 ,默认 为 1. 0f。 分 别 设置 0. 5f/1. 0f/1. 5f/2. 0f, 效 果 如 下 : 
abcdef 05F 

android; textScaleX abcdef 1.0f 


abcdef 1.5f 
abcdef 2.0f 
————————————— 
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属性 名 称 描 $ 

android. textSize 设置 文字 大 小 ,推荐 度量 单位 sp, 如 15sp 

dndéoid; texcStyle 设置 字形 [bold( 粗 体 ) 0，italic( 斜 体 ) 1，bolditalic( 又 粗 又 斜 ) 2] 可 以 设 
置 一 个 或 多 个 ,用 “1" 隔 开 

EE E A 设置 文本 字体 ,必须 是 以 下 常量 值 之 一 : normal 0, sans 1. serif 2, 
monospace( 等 宽 字 体 ) 3 

android: height 设置 文本 区 域 的 高 度 , 支 持 度量 单位 : px/dp/sp/in/mm 

android: maxHeight 设置 文本 区 域 的 最 大 高 度 

android:minHeight 设置 文本 区 域 的 最 小 高 度 

android: width 设置 文本 区 域 的 宽度 ,支持 度量 单位 : px/ dp/sp/in/mm 

android:maxWidth 设置 文本 区 域 的 最 大 宽度 

android : minWidth 设置 文本 区 域 的 最 小 宽度 


实例 : 使 用 TextView 设置 不 同 大 小 、 颜 色 、 作 用 的 文本 。 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android: layout_width = "match parent" 
android:layout height = "match parent" 
android:orientation = "vertical"» 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: text = "我 的 字体 大 小 为 20pt" 
android:textSize = "20pt"/> 


« TextView 

id:layout width = "wrap content" 
layout height = "wrap content" 
itext = "我 的 字体 颜色 是 红色 " 
:textColor = "@color/red" /> 





android:layout_width = "wrap content" 
android:layout height = "wrap content" 
singleLine = "true" 

text = "百度 一 下 : http://www. baidu. com" 
android:autoLink = "web"/» 





« TextView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android: text = "我 是 一 行 密码 " 
android:password = "true"/> 


</LinearLayout > 


代码 文件 : codes\03\3.2\TextViewDemo\res\layout\activity_main.xml 


将 上 面 这 个 XML 文件 作为 Activity 的 界面 文件 ， 
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并 将 应 用 部 团 在 Android 模拟 器 上 ,运行 效果 如 图 3. 12 


所 示 。 
实例 : 使 用 EditText 定义 一 个 友好 的 输入 界面 。 


< TableLayout xmlns:android = "http://schemas. android. 
com/apk/res/android" 
android: layout width= "match parent" 
android: layout height = "match parent" 
android: background = "@color/azure" 
android:padding = "10dip" 
android: stretchColumns = "1"> 


< TableRow > 

< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:gravity = "right" 
android:text = "账号 : "/> 

< EditText 
android:layout width = "wrap content" 
android:layout height = "wrap content" 


android:hint = "请 输入 账号 .…" 


我 的 字体 大 小 
为 20pt 


我 的 字体 颜色 是 红色 
百度 一 下 : http.//wwvibaldu.com 


图 3. 12 TextView 实例 


android:background = "@drawable/shurukuang"/> 


</TableRow > 


< TableRow 

android:layout marginTop = "10dip"> 

< TextView 
android: layout width= "wrap content" 
android:layout height = "wrap content" 
android:gravity = "right" 
android:text = "密码 : "/» 

< EditText 
android: layout_width = "wrap content" 
android:layout height = "wrap content" 
android:hint = "请 输入 密码 .…" 
android:password = "true" 


android:background = "(9 drawable/shurukuang" /> 


«/TableRow > 


< TableRow 

android:layout marginTop = "10dip"> 

< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "手机 号 码 : "/> 

« EditText 
android:layout width- "wrap content" 
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android:layout height = "wrap content" 

android:hint = "请 输入 您 的 手机 号 码 .…" 

android:phoneNumber = "true" 

android:background = "@drawable/shurukuang"/> 
</TableRow> 


</TableLayout > 

代码 文件 : codes\03\3.2\EditTextDemo\res\layout\activity_main. xml 
运行 效果 如 图 3. 13 所 示 。 DAME ss 
3.2.2 按钮 与 图 片 按钮 


账号 : 请 输入 账号 … 

上 面 提 到 过 ,Button( 按 钮 ) 为 TextView 的 直接 子 
类 ,而 ImageButton 继承 了 Button。 两 者 都 是 为 了 在 一 
UL 界面 上 生成 一 个 按钮 ,供用 户 单 击 或 双击 。 当 用 户 mee [8A 
单 击 或 双击 按钮 时 ,按钮 就 会 触发 一 个 单 击 或 双击 事 
件 , 完 成 某 些 动作 。 

Button 按钮 与 ImageButton 按钮 之 间 的 区 别 在 
于 : Button 按钮 上 显示 文字 ,而 ImageButton 上 显示 
图 片 。 

注意 : 为 ImageButton 按钮 指定 android: text 属 
性 是 没有 用 的 ,即使 指定 了 该 属性 ,图 片 按钮 上 也 不 会 
显示 任何 文字 。 

实例 : 按钮 与 图 片 按 钮 的 一 般 用 法 。 图 3.13 EditText 实例 


[MED 


的 手机 号 码 .. 








< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:orientation = "vertical" 
android:padding = "10dip"> 


<Button 
android:layout_width = "wrap content" 
android:layout height = "wrap content" 
android: text = "我 是 一 个 普通 按钮 " 
android:textSize = "10pt" 
android:background = "@color/red" /> 


< ImageButton 
android: layout_ width= "wrap_content" 
android:layout height = "wrap content" 
android:layout marginTop = "10dip" 
android: src = "(d drawable/bt2" 
android:background = "@color/yellow" /> 


< Button 


第 8 章 Android 基 本 界面 组 件 65 


android:layout width= "wrap content" zm 4B 6:52a« 
android:layout height = "wrap content" 
android:layout marginTop = "10dip" 
android:text = " 带 文字 的 图 片 按钮" 我 是 一 个 普通 按钮 
android:textSize = "10pt" À 
android:background = "@drawable/bt2"/> Lj 


c si 
代码 文件 : codes\03\3.2\ButtonDemo\res\ 


layout\activity main. xml 


运行 效果 如 图 3. 14 所 示 。 


3.2.8 单 选 按钮 与 复 选 框 


单 选 按 钮 (RadioButton) 和 复 选 框 (CheckBox) 都 继 
承 自 Button, 因 此 它们 可 以 直接 使 用 Button 支持 的 各 


ButtonDemo 





种 属性 。 

RadioButton 与 CheckBox 都 可 以 指定 android: 3.14 Button 与 ImageButton 
checked 属性 ,该 属性 用 来 设置 RadioButton 与 CheckBox 的 一 般 用 法 
的 选中 状态 。 


RadioButton 和 CheckBox 的 区 别 如 下 : 

æ ÉA RadioButton 在 选中 后 ,通过 单 击 无 法 变 为 未 选中 ; 单个 CheckBox 在 选中 后 ， 
通过 单 击 可 以 变 为 未 选中 。 

名 一 组 RadioButton ,只 能 同时 选中 一 个 ; 一 组 CheckBox, 能 同时 选中 多 个 。 

a RadioButton 在 大 部 分 UI 框架 中 默认 都 以 圆 形 表示 ; CheckBox 在 大 部 分 UI 框架 
中 默认 都 以 矩形 表示 o 

实例 : 使 用 RadioButton 和 CheckBox 显示 个 人 信息 。 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout_width = "match parent" 
android:layout height = "match parent" 
android:padding = "10dip" 
android:background = "(Z color/azure" 
android:orientation = "vertical"» 


< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: text = "请 选择 您 的 性 别 : " 
android: textSize = "9pt" 
android: layout_gravity = "center vertical"/» 
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< RadioGroup 


android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:orientation = "horizontal" 


< RadioButton 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = " 男 "/> 


<RadioButton 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout marginLeft = "10dip" 
android: text = " 女 "/> 


</RadioGroup> 

</LinearLayout > 

<LinearLayout 
android:layout width= "fill parent" 
android:layout height = "wrap content" 


android:orientation = "horizontal" 


< TextView 


android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "请 选择 您 的 爱好 : " 
android:textSize = "9pt"/> 


< LinearLayout 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "vertical" 


< CheckBox 
androii 





:layout width- "wrap content" 
android:layout height - "wrap content" 
android: text = "看 书 "/> 


< CheckBox 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: text = " 听 歌 "/> 


< CheckBox 


android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "看 电影 "/> 


</LinearLayout > 
</LinearLayout > 


</LinearLayout > 
代码 文件 : codes\03\3. 2\RadioBttonCheckBoxDemo\ 
res\layout\activity main. xml 


运行 效果 如 图 3. 15 所 示 。 
3.2.4 开关 按钮 


android. widget. ToggleButton 译 为 开关 按钮 ， 
ToggleButton 通过 一 个 带 有 亮度 指示 同时 默认 文本 为 
ON 3& OFF 的 按钮 显示 选中 或 未 选中 状态 ,ToggleButton 
也 只 有 这 两 种 状态 ,在 这 两 种 状态 间 切 换 的 同时 可 以 修 
改 开 关 按 钮 上 的 默认 文本 。 

ToggleButton 支持 如 表 3. 6 所 示 的 XML 属性 。 
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BM S s:11ww 
RadioButtonCheckBoxDemo 


请 选择 您 的 性 别 : @s @x 

请 选择 您 的 受 好 : gas 
mL 
(jesse 


图 3.15 使 用 RadioButton 和 
CheckBox 显示 个 人 信息 


表 3.6  ToggleButton 支持 的 XML 属性 


属性 名 称 


d R 





android:disabledAlpha 


设置 按钮 在 禁用 时 透明 度 

















android:checked 设置 该 按钮 是 否 被 选中 
android ; textOff 未 选中 时 按钮 的 文本 
android: textOn 选中 时 按钮 的 文本 


实例 : 用 开关 按钮 来 控制 白天 与 黑夜 之 间 的 切换 。 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android:layout width- "match parent" 
android:layout height = "match parent" 
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android:background = "@drawable/day" 
android: id= "@ + id/layout"> 


< ToggleButton 
android: layout width= "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android:textOn- "EX" 
android:textOff = "黑夜 " 
android:checked = "true" 
android:id- "(2 + id/toggle"/» 


«/LinearLayout > 
代码 文件 : codes V03V3. 2VToggleButtonDemoVresMlayoutVactivity main. xml 


上 面 的 XML 代码 文件 定义 了 一 个 界面 ,界面 的 背景 为 一 张 资源 id 为 day 的 图 片 ,该 图 
片 景色 为 “白天 ”, 接 着 在 界面 上 放置 了 一 个 状态 开关 按钮 ,下 面 的 程序 代码 用 来 切换 开关 状 
态 同时 更 改 界面 背景 图 片 。 


package cn. edu. hstc. togglebutton. activity; 


import android. app. Activity; 

import android. os. Bundle; 

import android. widget. CompoundButton; 

import android. widget. CompoundButton. OnCheckedChangeListener; 
import android. widget.LinearLayout; 

import android. widget. ToggleButton; 


public class MainActivity extends Activity ( 

// 声 明 界 面 布局 

private LinearLayout layout; 

// 声 明 开 关 按 钮 ToggleButton 

private ToggleButton toggle; 

(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout.activity main); 
initWidget(); 


private void initWidget() ( 
// 通 过 资源 id 获取 界面 布局 以 及 界面 文件 中 的 ToggleButton 
layout = (LinearLayout) this. findViewById(R. id. layout); 
toggle = (ToggleButton) this. findViewById(R. id. toggle); 


toggle. setOnCheckedChangeListener(new OnCheckedChangeListener() { 
(2 Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 


if (isChecked) { ”// 当 开关 打开 时 ,界面 背景 图 片 为 白天 
layout. setBackgroundResource(R. drawable. day); 


} else { // 当 开关 关闭 时 ,界面 背景 图 片 为 黑夜 
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layout. setBackgroundResource(R. drawable. night) ; 


np; 


} 
codes V 03 V 3. 2 X ToggleButtonDemo V src V cn V edu V hstc V togglebutton V activity V 
MainActivity. java 
将 程序 部 署 在 Android 模拟 器 上 ,运行 效果 如 图 3. 16 所 示 。 
当 用 户 单 击 开关 按钮 ,运行 效果 如 图 3. 17 所 示 。 
BMB 1:42am BME 1:431 
ButtonD 





ToggleButtonDemo 





图 3.16 开关 打开 ,白天 背景 图 3. 17 开关 关闭 ,黑夜 背景 


3.2.5 时 钟 


在 Android 中 有 两 个 组 件 可 以 用 来 显示 时 间 : 一 个 是 AnalogClock ,该 组 件 模拟 了 现实 
中 的 时 钟 界面 ; 另 一 个 是 DigitalClock ,该 组 件 只 是 简单 地 显示 当前 时 间 , 本 身 可 看 作 是 一 
个 现实 内 容 为 当前 时 间 的 TextView。 这 两 个 组 件 的 使 用 都 比较 简单 ,只 需要 在 布局 文件 中 
写 人 这 两 个 组 件 并 设置 其 位 置 即 可 。 

实例 : 在 界面 中 使 用 AnalogClock 和 DigitalClock 来 显示 当前 时 间 。 





< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android: layout_width = "match parent" 
android:layout_height = "match_parent" 
android: background = "@color/azure" 
android:gravity = "center" 
android:orientation = "vertical"> 


< AnalogClock 


le) 
w 
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android:layout width- "wrap content" 
android:layout height = "wrap content"/» 


< DigitalClock 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:textSize - "l4pt"/» 


«/LinearLayout > 
代码 文件 : codes V03V3. 2V AnalogClockDigitalClockDemo VresMayoutNVactivity main. xml 
运行 效果 如 图 3. 18 所 示 。 


BM B 2:47 
AnalogClockDigitalClockDemo 
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2:47:45 am 


3.18 显示 当前 时 间 


3.2.6 图 像 视 图 


android. widget. ImageView 译 为 图 像 视 图 ,直接 继承 自 android. view. View, 显 示 任 意 
图 像 ,例如 图 标 。ImageView 类 可 以 加 载 各 种 来 源 的 图 片 ( 如 资源 或 图 片 库 ) ,需要 计算 图 
像 的 尺寸 , 比 便 它 可 以 在 其 他 布局 中 使 用 ,并 提供 例如 缩放 和 着 色 ( 演 染 ) 各 种 显示 选项 。 
ImageView 支持 表 3.7 所 示 的 XML 属性 。 


表 3.7 ImageView 支持 的 XML 属性 








属性 名 称 描 述 
android:adjustViewBounds 设置 该 属性 为 真 , 可 以 在 ImageView 调整 边界 时 保持 图 片 的 纵横 比例 
android :baseline 视图 内 基线 的 偏 移 量 





android: baselineAlignBottom | 如 果 为 true, 图 像 视图 将 基线 与 父 控件 底部 边缘 对 齐 
android : cropToPadding 如 果 为 true, 则 剪 切 图 片 以 适应 内 边 距 的 大 小 
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续 表 
属性 名 称 描 xk 





为 视图 提供 最 大 高 度 的 可 选 参数 。( 单 独 使 用 无 效 , 需 要 与 
setAdjustViewBounds 一 起 使 用 。 如 果 想 设置 图 片 固定 大 小 ,又 想 保持 图 
片 宽 高 比 ,需要 如 下 设置 : 

(1) 设置 setAdjustViewBounds 为 true; 

(2) 设置 maxWidth、MaxHeight; 

(3) 设置 layout_width 和 layout_height 为 wrap_content) 


android ; maxHeight 





android : maxWidth 为 视图 提供 最 大 宽度 的 可 选 参数 





控制 为 了 使 图 片 适合 ImageView 的 大 小 ,应 该 如 何 变更 图 片 大 小 或 移动 
图 片 。 一 定 是 下 列 常 量 之 一 : 




















常量 值 描述 

matrix 0 | 用 矩阵 来 绘图 

fitXY 1 | 拉 伸 图 片 (不 按 比 例 ) 以 填充 View 的 宽 高 

PE 2 按 比例 拉 伸 图 片 , 拉 伸 后 图 片 的 高 度 为 View 的 
高 度 , 且 显示 在 View 的 左边 

: 按 比 例 拉 伸 图 片 , 拉 伸 后 图 片 的 高 度 为 View 的 

fitCenter 3 

android:scaleType 高 度 , 且 显示 在 View 的 中 间 

i 按 比例 拉 伸 图 片 , 拉 伸 后 图 片 的 高 度 为 View 的 

高 度 , 且 显示 在 View 的 右边 





按 原 图 大 小 显示 图 片 ,但 图 片 宽 高 大 于 View 的 
宽 高 时 ,截图 图 片 中 间 部 分 显示 

centerCrop 6 | 按 比例 放大 原 图 直至 等 于 某 边 View 的 宽 高 显示 
当 原 图 宽 高 或 等 于 View 的 宽 高 时 , 按 原 图 大 小 
centerInside | 7 | 居中 显示 ; 反之 将 原 图 缩放 至 View 的 宽 高 居中 


center 5 
































显示 
android; src 设置 可 绘制 对 象 作为 ImageView 显示 的 内 容 
android :tint 为 图 片 设置 着 色 颜色 


实例 : 使 用 ImageView 制作 一 个 图 片 查看 器 。 


<RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout_width = "match parent" 
android:layout height = "match parent" 
android:background = "(2 color/azure"» 


< TableLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:stretchColumns = "0,1" 
android:layout alignParentBottom = "true" 
android:id- "(9 + id/layout" 
< TableRow> 
< Button 
android:layout width- "wrap content" 
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android:layout height = "wrap content" 
android:text- " p —3K" 
android: enabled = "false" 
android:id- "(9 + id/btnPrev"/» 
< Button 

android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "下 一 张 " 
android:id- "@ + id/btnNext"/> 

</TableRow> 

</TableLayout > 


< ImageView 
android:layout width= "fill parent" 
android:layout height = "fill parent" 
android: src = "(Qdrawable/a" 
android: scaleType = "fitXY" 
android:layout above = "@ id/layout" 
android: id = "@ + id/imageView" /» 
</RelativeLayout > 
代码 文件 : codes\03\3.2\ ImageViewDemo\res\layout\activity_main. xml 


上 面 的 XML 界面 文件 在 界面 底部 左右 排放 了 两 个 按钮 : 一 个 用 于 查看 上 一 张 图 片 ,一 
个 用 于 查看 下 一 张 图 片 ,接着 在 这 两 个 按钮 的 上 方 定义 了 一 个 ImageView 用 于 盛 放 图 片 ， 
ImageView 的 宽 高 填充 了 除了 两 个 按钮 所 占 的 其 他 界面 的 宽 高 。 下 面 的 程序 代码 实现 单 
击 界面 中 的 两 个 按钮 以 便 按 顺 序 查 看 上 一 张 或 者 下 一 张 图 片 的 功能 。 





package cn. edu. hstc. imageviewdemo. activity; 


import android. app. Activity; 

import android. graphics. BitmapFactory; 

import android. graphics. drawable. BitmapDrawable; 
import android. os. Bundle; 

import android. view. View; 

import android. widget. Button; 

import android. widget. ImageView; 


public class MainActivity extends Activity ( 
private Button btnPrev, btnNex; 
private ImageView imageView; 
int[] images = new int[] (R.drawable.a, R.drawable.b, R. drawable. c}; 
int currentlImage = 0; 
(QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. activity main); 
initWidget(); 


第 3 章 Android 基 本 界面 组 件 73 


private void initWidget() { 
btnPrev = (Button) this.findViewById(R. id. btnPrev); 
btnNex = (Button) this. findViewById(R. id. btnNext); 
imageView = (ImageView) this.findViewById(R. id. imageView); 
btnPrev.setOnClickListener(new TheOnClickListener()); 
btnNex. setOnClickListener(new TheOnClickListener()); 


private class TheOnClickListener implements View.OnClickListener { 
(QOverride 
public void onClick(View v) { 
BitmapDrawable bitmapDrawable = (BitmapDrawable) imageView.getDrawable(); 
if (!bitmapDrawable. getBitmap(). isRecycled()) ( // 如 果 未 回收 图 片 ,强制 回收 
bitmapDrawable.getBitmap().recycle(); 
) 
switch (v.getId()) ( 
case R. id. btnPrev: 
imageView. setImageBitmap (BitmapFactory. decodeResource ( getResources ( ), 
images[ -- currentImage])); 
if (currentImage «- 0) { 
currentlImage = 0; 
btnPrev. setEnabled(false); 
) else if (currentImage «2) ( 
btnNex. setEnabled(true); 
) 
break; 
case R. id. btnNext: 
imageView. setImageBitmap (BitmapFactory. decodeResource ( getResources ( ), 
images[-**currentImage])); 
if (currentImage» - 2) ( 
currentlImage = 2; 
btnNex. setEnabled(false); 
) else if (currentImage» 0) ( 
btnPrev. setEnabled(true); 
) 
break; 
default: 
break; 


codes V 03 \ 3. 2 \ ImageViewDemo V src V cn V edu V hstc V imageviewdemo V activity V 
MainActivity. java 
将 应 用 部 署 到 模拟 器 上 ,运行 程序 .车 当前 图 片 为 第 一 张 图 片 时 ,“ 上 一 张 ” 按 钮 不 可 用 ， 
若 当 前 图 片 为 最 后 一 张 图 片 时 ,“ 下 一 张 ”按钮 不 可 用 。 运 行 效果 如 图 3. 19 所 示 。 
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BAME 722. 


ImageViewDemo 








3. 19 ImageView 照片 查看 器 


8.8 本 章 小 结 


本 章 重 点 介绍 了 Android 五 大 布局 ,其 中 读者 必须 重点 关注 的 是 线性 布局 、 表 格 布局 以 
及 相对 布局 ,因为 这 三 个 布局 在 具体 的 Android 程序 开发 中 是 较 常用 的 ,而 这 三 个 布局 之 中 
又 属 线性 布局 尤为 常用 。 接 着 ,介绍 了 Android 基本 界面 组 件 ,因为 应 用 的 最 终 用 户 是 一 些 
不 太 懂 软件 的 人 ,那么 与 用 户 交互 的 软件 界面 是 否 友好 就 在 某 个 程度 决定 了 用 户 对 该 应 用 
的 喜爱 和 依赖 程度 ,掌握 好 界面 编程 的 重要 性 可 见 一 斑 。 在 接 下 来 的 第 4 章 中 ,我 们 将 对 
Android 的 高 级 组 件 编程 进行 系统 的 学 习 。 





Android 高 级 界面 组 件 | 


第 3 章 介 绍 了 Android 的 基本 界面 组 件 , 在 实际 项 目 开发 中 ,我 们 也 会 使 用 到 Android 
一 些 比较 高 级 的 控件 ,这 些 控件 的 使 用 使 我 们 开发 出 来 的 程序 更 显 * 高 大 上 ”, 更 加 智能 化 ， 
也 正 因为 这 些 高 级 控件 的 使 用 , 才 丰 富 了 我 们 的 应 用 。 


@.1 Android 高 级 界面 组 件 的 组 成 


Android 的 高 级 界面 组 件 包括 自 动 完成 文本 框 、 下 拉 列 表 框 spinner、 日 期 时 间 选 择 器 、 
进度 条 、 拖 动 条 、 星 级 评分 条 .选项 卡 滚动 视图 、 列 表 视 图 等 ,本 节 将 重点 介绍 这 几 种 组 件 。 


4.1.1 自动 完成 文本 框 


假如 现在 正在 编制 一 个 地 图 的 应 用 ,我 们 在 界面 中 放置 了 一 个 文本 框 , 用 于 输入 地 址 ， 
然后 希望 在 输入 “ 韩 " 这 个 字 的 时 候 就 会 以 下 拉 框 的 形式 联想 显示 类 似 于 “韩文 公 祠 “* 韩 山 
师范 学 院 ” 这 样 的 一 些 地 址 供 我 们 直接 选择 ,完成 地 址 文本 框 的 输入 。 这 个 时 候 会 用 到 的 一 
个 Android 控件 便 是 自动 完成 文本 框 AutoCompleteTextView, 4 4.1 介绍 了 AutoCom- 
pleteTextView 的 一 些 常用 属性 及 其 对 应 功能 。 


表 4.1 AutoCompleteTextView 常用 属性 





m 性 说 o" 
android:completionHint 设置 出 现在 下 拉 菜 单 中 的 提示 标题 
android:completionThreshold 设置 用 户 至 少 输入 多 少 个 字符 才 会 显示 提示 
android:dropDownHorizontalOffset 下 拉 菜 单 于 文本 框 之 间 水 平 偏 移 。 默 认 与 文本 框 左 对 齐 
android : dropDownHeight 下 拉 框 的 高 度 
android:dropDownWidth 下 拉 框 的 宽度 
android:singleLine 单行 显示 
android:dropDownVerticalOffset 垂直 偏 移 量 
android; popupBackground 设置 下 拉 框 的 背景 


使 用 AutoCompleteTextView 需要 为 它 设置 一 个 Adapter 适配器 ,该 Adapter 封装 了 
AutoCompleteTextView 预 设 的 提示 文本 。 
实例 : 自动 完成 地 址 输入 框 信息 输入 。 


« LinearLayout xmlns:android = "http://schemas.android. con/apk/res/android" 
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android:layout width- "match parent" 
android:layout height = "match parent" 
android:orientation = "horizontal" > 


< AutoCompleteTextView 
android:id- "(2 + id/txt auto address" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:completionThreshold - "1" 
android:hint = "请 输入 地 址 .…" 
android:popupBackground = " # 444444" 
android: textColor = "@android:color/secondary_text_dark" /> 


</LinearLayout > 
代码 文件 : codes\04\4. 1\AutoCompleteTextViewDemo\res\layout\activity_main. xml 


上 面 界面 文件 实现 将 一 个 自动 完成 文本 框 放 置 于 界面 中 ,并 设置 了 自动 完成 文本 框 的 
下 拉 框 的 背景 颜色 为 黑色 ,文本 框 的 字体 颜色 为 灰色 ,并且 设置 当 用 户 输入 一 个 字符 的 时 候 
就 会 自动 提示 文本 。 


package cn. edu. hstc. autocompletetextviewdemo. activity; 


import android. app. Activity; 

import android. os. Bundle; 

import android. widget. ArrayAdapter; 

import android. widget. AutoCompleteTextView; 


public class MainActivity extends Activity ( 
String[] address = new String] {“" 广 东 潮州 "，" 广 东 汕头 "，" 广 东 揭 阳 "，" 广 东 深圳 "，" 广 
东 广州 "，" 广 东 珠 海 " } ; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
// 创 建 适配器 
Arrayhdapter« String» add = new ArrayAdapter < String »(MainActivity. this, android. 
R.layout.simple dropdown item lline, address); 
AutoCompleteTextView act - (AutoCompleteTextView) this .findViewById(R. id. txt auto 
address); 
// 为 自动 完成 输入 框 设置 设 配器 
act. setAdapter (add) ; 


代码 文件 : codes\04\4.1\AutoCompleteTextViewDemo\src\cn\edu\hstc\autocompletetextview\ 
activity\MainActivity. java 
将 程序 部 署 在 Android 模拟 器 上 ,运行 效果 如 图 4. 1 所 示 。 
如 图 4. 1 Bros ,用 户 只 需 选 中 任何 一 个 选项 , 便 可 自动 完成 地 址 文本 框 的 信息 输入 。 
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广东 汕头 


广东 揭阳 


广东 深圳 
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广东 珠海 
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图 4.1 自动 完成 地 址 输入 


4.1.2 下 拉 列 表 框 的 功能 和 用 法 


下 拉 列 表 框 Spinner 提供 一 种 下 拉 列 表 框 选择 的 输入 方式 ,在 手机 应 用 界面 上 非常 常 
见 , 使 用 Spinner 可 以 节省 有 限 的 屏幕 空间 占用 。 

有 两 种 方法 可 以 配置 下 拉 列 表 控 件 的 下 拉 内 容 项 : 一 种 是 在 XML 文件 中 预先 定义 数 
据 , 另 一 种 是 在 编程 的 时 候 载 和 人 数据。 如果 下 拉 列 表 框 中 的 列表 项 是 确定 的 ,那么 建议 采用 
XML 预 设 方式 。 接 下 来 首先 介绍 这 种 配置 方式 。 

实例 : 下 拉 列 表 框 Spinner 的 使 用 。 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout_width= "match parent" 
android:layout height = "match parent" 
android:orientation = "vertical" » 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "Spinner 数据 源 来 自 XML 文件 " /> 


< Spinner 
android:id- "@ + id/spinner xml" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:entries = "(Qarray/education" 
android:prompt = "(Zstring/hint" /> 
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< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "在 java 文件 中 加 载 Spinner 数据 源 " /> 


< Spinner 
android:id- "(à + id/spinner java" 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
android:prompt = "(Qstring/hintl" /> 


«/LinearLayout > 
代码 文件 : codes\04\4. 1NSpinnerDemoVresMayoutVactivity main. xml 


由 于 上 面 的 界面 代码 中 为 Spinner 控件 指定 了 一 个 XML 文件 中 的 数组 作为 其 数据 源 ， 
所 以 这 里 需要 新 建 一 个 文件 ,代码 如 下 : 





<?xml version = "1.0" encoding = "UTF - 8"?> 
< resources » 
< string- array name = "education"> 
< item > 博士 研究 生 </item> 
< item > 硕士 研究 生 </item> 
< item> 本 科 </item> 
<item> 专 科 </item> 
«/string- array» 
«/resources > 
代码 文件 : codes\04\4. 1NSpinnerDemoVres value Veducation. xml 


使 用 XML 作为 Spinner 的 数据 源 这 种 方式 的 特点 GN e: 
是 代码 简单 ,将 程序 部 署 在 模拟 器 上 ,运行 效果 如 图 4. 2 
所 示 。 

接 下 来 继续 介绍 在 Java 程序 中 为 Spinner 控件 加 
载 数据 源 的 方式 ,这 是 一 种 可 以 配置 Spinner 下 拉 列 表 
项 内 容 的 方式 。 

这 种 方式 与 将 XML 文件 中 的 数组 配置 为 Spinner 博士 研究 生 
的 数据 源 的 方式 的 主要 区 别 在 于 MainActivity. java, 
该 类 文件 的 代码 如 下 : ANRE 


package cn. edu. hstc. spinnerdemo. activity; 本 科 


import android. app. Activity; 


专科 


import android. os. Bundle; 
import android. widget. ArrayAdapter; 
import android. widget. Spinner; 





public class MainActivity extends Activity ( 
// 定 义 需要 载 人 的 数据 


private static final String[ ] EXPRESS_STRINGS = 图 4.2 Spinner 的 用 法 (一 ) 
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{" 顺 丰 速 递 "," 申 通 快 递 "," 圆 通 快 递 "，" 中 通 快 递 "}; 
// 声 明 Spinner 对 象 
private Spinner expressSpinner; 
// 声 明 适 配器 对 象 
private ArrayAdapter < String> adater; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate( savedInstanceState); 
setContentView(R. layout.activity main); 


// 从 布局 文件 中 加 载 Spinner 对 象 
expressSpinner = (Spinner) MainActivity.this.findViewById(R. id. spinner java); 
// 创 建 适配器 


adater = new ArrayAdapter < String »(MainActivity. this, android. R. layout. simple - 
Spinner item, EXPRESS STRINGS); 

// 将 适配器 设置 到 Spinner 中 

expressSpinner. setAdapter(adater); 


代码 文件 : codes\04\4. 1\SpinnerDemo\cn\edu\hstc\activity\MainActivity. java 
将 应 用 再 次 部 署 到 模拟 器 上 ,运行 效果 如 图 4. 3 所 示 。 
E] Fi 4:03 Pm 





选择 一 个 快递 公 局 


图 4.3 Spinner 的 用 法 (二 ) 
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4.1.3 日 期 .时间 选择 器 


日 期 选择 控件 DatePicker 继承 自 FrameLayout 类 ,其 主要 功能 是 向 用 户 提 供 包含 年 、 
月 \ 日 的 日 期 数据 并 允许 用 户 对 其 进行 修改 。 如 果 要 捕获 用 户 修改 日 期 选择 控件 中 的 数据 
事件 ,需要 为 DatePicker 添加 OnDateChangedListener 监听 器 。 

时 间 选 择 器 TimePicker 也 继承 自 FrameLayout 类 ,其 主要 功能 是 向 用 户 显示 一 天 中 
的 时 间 ,可 以 为 24 小 时 的 格式 ,也 可 以 为 AM/PM 制 ,并 允许 用 户 进行 选择 。 如 果 要 捕获 
用 户 修 改 时 间 数 据 事件 ,需要 为 TimePicker 添加 OnTimeChangedListener 监听 器 。 

以 下 通过 一 个 让 用 户 选 择 日 期 .时 间 的 实例 来 示范 DatePicker 和 TimePicker 的 功能 和 
用 户 。 界 面 代码 如 下 : 


<LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android: layout width= "match parent" 
android:layout height = "match parent" 
android:background = "(2 android:color/white" 
android:orientation = "vertical" > 


< TextView 
android:id- "@ + id/txt show" 
android:layout width- "fill parent" 
android:layout height - "wrap content" 
android:paddingLeft = "5dp" 
android:paddingTop = "10dp" 
android:textColor = "(Qandroid:color/black" /> 


< DatePicker 
android: id = "(9 + id/datePicker" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center horizontal" 
android:paddingTop = "5dp" /> 


« TinePicker 
android:id- "(9 + id/timePicker" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center horizontal" 
android:paddingTop = "5dp" /> 


«/LinearLayout > 
代码 文件 : codes\04\4. 1NDateTimePickerDemoVXresMlayoutVactivity main. xml 


该 代码 实现 在 界面 中 从 上 至 下 放置 一 个 TextView, 用 于 显示 日 期 与 时 间 ; 一 个 
DatePicker 日 期 控件 ; 一 个 TimePicker 时 间 控 件 , 用 于 供用 户 设置 日 期 和 时 间 。 


package cn. edu. hstc. datetimepickerdemo. activity; 


import java. util. Calendar; 
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import android. app. Activity; 

import android. os. Bundle; 

import android. widget. DatePicker; 

import android. widget. DatePicker. OnDateChangedListener; 
import android. widget. TextView; 

import android. widget. TimePicker; 

import android. widget. TimePicker. OnTimeChangedListener; 


public class MainActivity extends Activity { 
// 声 明 五 个 记录 当前 时 间 的 变量 
private int year, month, day, hour, minute; 
private DatePicker datePicker; 
private TimePicker timePicker; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 


setContentView(R. layout.activity main); 


datePicker = (DatePicker) findViewById(R. id.datePicker); 
timePicker - (TimePicker) findViewById(R. id. timePicker); 
// 获 取 当 前 年 月 .日 小时、 分钟 


Calendarc  - Calendar.getInstance(); 
year 7 c.get(Calendar. YEAR) ; 

month = c.get(Calendar. MONTH); 

day 7 c.get(Calendar.DAY OF MONTH); 


hour 


7 c.get(Calendar. HOUR) ; 


minute = c.get(Calendar. MINUTE); 


datePicker. init(year, month, day, new OnDateChangedListener() { 


n; 


(2 0Override 


public void onDateChanged(DatePicker view, int year, int month, int day) ( 


MainActivity.this.year = year; 
MainActivity.this.month - month; 
MainActivity.this.day - day; 
show(year, month, day, hour, minute); 


timePicker. setIs24HourView(true); 

timePicker. setCurrentHour(hour); 

timePicker. setCurrentMinute(minute); 

timePicker. setOnTimeChangedListener(new OnTimeChangedListener() { 


(2 Override 

public void onTimeChanged(TimePicker view, int hour, int minute) { 
MainActivity.this.hour - hour; 
MainActivity.this.minute = minute; 
show(year, month, day, hour, minute); 
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D; 
) 


private void show(int year, int month, int day, int hour, int minute) ( 
TextView show = (TextView) findViewById(R. id.txt show); 
show. setText(" 选 择 的 日 期 和 时 间 为 : " + year + "Æ" + (month + 1) + "H" + day + 
"H" + hour + "时 "+ minute + "分 "); 
) 
} 
代码 文件 : codes\04\4. 1\DateTimePickerDemo\cn\edu\hstc\activity\MainActivity. java 
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图 4.4 日 期 时 间 控 件 的 功能 与 用 法 


4.1.4 进度 条 的 介绍 与 应 用 


进度 条 ProgressBar 是 个 非常 实用 的 组 件 ,最 直观 的 作用 就 是 提供 进度 的 显示 ,通常 向 
用 户 展 示 某 个 耗 时 操作 完成 的 百分比 。 例 如 , 流 媒体 播放 的 缓冲 区 进度 .加载 网 络 内 容 的 进 
度 ,进度 条 的 显示 避免 让 用 户 感觉 应 用 程序 失去 了 响应 ,改善 了 用 户 体 验 

Android 对 进度 条 提供 了 几 种 不 同 风格 的 样式 ,通过 style 属性 可 以 设置 ProgressBar 
的 风格 ,该 属性 支持 如 下 属性 值 : 





æ @android:style/Widget. ProgressBar. Horizontal 一 一 水 平 进 度 条 
æ (Q android: style/ Widget. ProgressBar. Inverse 一 一 不 断 跳跃 .旋转 画 TT Jt BE A 
= (OQ android: style/ Widget. ProgressBar. Large 一 一 大 进度 条 。 


名 @android: style/ Widget. ProgressBar. Large. Inverse 一 一 不 断 跳跃 .旋转 画面 的 大 
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进度 条 。 

 (Q android : style/ Widget. ProgressBar. Small 小 进度 条 。 

名 @android:style/ Widget. ProgressBar. Small. Inverse 一 一 不 断 跳跃 .旋转 画面 的 小 进 
度 条 。 

ProgressBar 也 支持 如 表 4. 2 所 示 的 常用 XML 属性 。 


表 4.2 ProgressBar 常用 XML 属性 








XML 属性 说 明 
android:max 设置 进度 条 的 最 大 值 
android: progress 设置 进度 条 的 已 完成 进度 值 
android :progressDrawable 设置 进度 条 的 轨道 绘制 形式 
android:progressBarStyle 默认 进度 条 样式 
android: progressBarStyleHorizontal 水 平 进 度 条 样式 
android :progressBarStyleLarge 大 进度 条 样式 
android :progressBarStyleSmall 小 进度 条 样式 


最 常见 的 ProgressBar 是 水 平 进度 条 与 圆 形 进度 条 ,下 面 通过 一 个 实例 来 介绍 这 两 种 
实例 : 进度 条 的 功能 和 用 法 。 界 面 代码 如 下 : 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
xmlns:tools = "http://schemas.android. com/tools" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:paddingLeft = "10dp" 
android:orientation = "vertical" > 


< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:paddingTop = "10dp" 
android:orientation = "horizontal" > 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 


android: text = "水 平 进度 条 当前 进度 值 : ”人 > 


< TextView 
android:id- "@ + id/txt horizontal" 
android:layout width- "wrap content" 
android:layout height = "wrap content" /> 





«/LinearLayout > 


< ProgressBar 
android:id="@ + id/bar_horizontal" 
android: layout width= "170dp" 
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android:layout height = "wrap content" 
android:paddingTop - "5dp" 
android:max- "100" 


style = "@android: style/Widget. ProgressBar. Horizontal" /> 


< LinearLayout 


android:layout_width = "fill_parent" 
android:layout height = "wrap content" 
android:paddingTop = "10dp" 
android:orientation = "horizontal" 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: 





< TextView 
android:id- "(à + id/txt default" 
android:layout width = "wrap content" 


android:layout height = "wrap content" /» 
«/LinearLayout > 


< ProgressBar 


android: id="@ + id/bar default" 
android:layout_width = "wrap_content" 
android:layout height = "wrap content" 
android:paddingTop = "5dp" /> 


«/LinearLayout > 


局 形 进 度 条 当前 进度 值 : " /> 


代码 文件 : codes\04\4. 1\ProgressBarDemo\res\layout\activity_main. xml 


在 上 述 界面 代码 中 ,从 上 而 下 放置 了 两 个 进度 条 : 一 个 为 水 平 进度 条 ,一 个 为 默认 的 圆 


形 进度 条 。 同 时 放置 了 两 个 TextView 用 于 显示 进度 条 


当前 进度 值 , 这 两 个 进度 值 是 随 着 


进度 条 的 进度 百分比 不 断 变 化 的 ,实现 实时 更 新 进度 值 。 核 心 的 业务 代码 如 下 : 


package cn. edu. hstc. progressbardemo. activity; 


import android. app. Activity; 


import android. os. Bundle; 
import android. os.Handler; 
import android. os. Message; 
import android. view. View; 


import android. widget. ProgressBar; 
import android. widget. TextView; 


public class MainActivity extends Activity ( 


// 声 明 界 面 中 的 进度 条 


private ProgressBar horizontalBar, defaultBar; 
private TextView horizontalTxt, defaultTxt; 


// 声 明 一 个 Handler 
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private Handler handler; 
// 声 明 一 个 变量 用 于 存放 进度 条 的 进度 值 


private int progress; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout.activity main); 
// 通 过 1d 获取 界面 中 的 进度 条 
horizontalBar = (ProgressBar) MainActivity.this.findViewById(R. id. bar horizontal); 
defaultBar = (ProgressBar) MainActivity. this. findViewById(R. id. bar default); 
horizontalTxt = (TextView) MainActivity.this.findViewById(R. id. txt horizontal); 
defaultTxt = (TextView) MainActivity. this. findViewById(R. id. txt. default); 


// 创 建 一 个 Handler 
handler = new Handler() { 
@Override 
public void handleMessage(Message msg) { 
super. handleMessage(nsg) ; 
Switch (msg.what) ( 
case OX11: 
// 设 置 进度 条 的 当前 进度 以 及 EditText 中 的 值 
horizontalBar. setProgress(progress); 
horizontalTxt. setText(String. valueOf(progress)); 
defaultBar.setProgress(progress); 
defaultTxt. setText (String. valueOf (progress)); 
if (progress -- 100) ( 
defaultBar. setVisibility(View. INVISIBLE); 
) 
break; 
default: 
break; 


h 


// 创 建 一 个 线程 用 于 改变 进度 值 
new Thread(new Runnable() ( 
(2 0Override 
public void run() ( 
int max = horizontalBar.getMax(); 
try { 
while (progress < max) { 
progress += 10; 
Message msg = new Message(); 
msg. what = 0X11; 
handler. sendMessage(msg) ; 
Thread. s1eep(1000); 
) 
} catch (Exception e) ( 
e. printStackTrace(); 
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} 水 平 进度 条 当前 进度 值 : 45 
} -M 


代码 文件 : codes\04\4. 1\ProgressBarDemo\ 国 形 进度 条 当前 进度 值 : 45 
cn\edu\hstc\activity\MainActivity. java "s 
在 MainActivity 类 中 ,开启 一 条 子 线程 不 断 将 ex? 
进度 条 的 进度 值 加 10, 直 到 该 值 等 于 100, 并 在 子 
线程 中 发 送 消息 给 一 个 handler, 通 知 其 更 新 界面 
中 的 进度 条 当前 进度 值 , 实 现实 时 更 新 进度 条 。 将 
程序 部 署 在 模拟 器 上 ,运行 效果 如 图 4. 5 所 示 。 


4.1.5 拖 动 条 的 介绍 与 应 用 


拖 动 条 SeekBar, 顾 名 思 义 ,是 一 种 允许 用 户 手 

动 拖 动 来 改变 值 的 组 件 ,类 似 水 平 的 ProgressBar, 

只 是 ProgressBar 用 颜色 的 填充 来 表示 进度 条 的 完 

成 百分比 ,而 SeekBar 通过 滑 块 的 位 置 来 标识 数 

值 。 由 于 SeekBar 允许 用 户 手 动 拖 动 ,因此 常 被 用 

于 调节 音量 、 亮 度 、 对 比 度 、 饱 和 度 等 , 旨 在 对 系统 4.5  ProgressBar 的 功能 和 用 法 
某 个 数值 进行 调节 。 

SeekBar 可 以 被 用 户 控制 ,因此 需要 对 其 进行 事件 监听 ,这 就 需要 实现 SeekBar. 
OnSeekBarChangeListener 接口 。 在 SeekBar 中 需要 监听 三 个 事件 ,分 别 是 数值 的 改变 
ConProgressChanged) , Jf. lt Hi 2JJ C onStart Tracking Touch )、 停 止 拖 动 (onStopTrackingTouch )。 
在 onProgressChanged 中 可 以 得 到 当前 数值 的 大 小 。 

SeekBar 还 允许 用 户 自 定义 拖 动 条 的 滑 块 外 观 , 用 户 可 以 通过 android: thumb 属性 来 
设置 ,该 属性 指定 一 个 Drawable 对 象 ,将 该 对 象 作 为 自 定义 滑 块 。 下 面 通过 一 个 实例 来 演 
示 拖 动 条 的 开发 。 

实例 : 使 用 拖 动 条 SeekBar 控制 图 片 大 小 。 





<LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
xmlns:tools = "http://schemas. android. com/tools" 
android:layout_width = "match parent" 
android:layout height - "match parent" 
android:background = "(Zandroid:color/black" 
android:orientation = "vertical" > 


< SeekBar 
android:id- "(9 + id/seekBar" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:max = "200" 


android:progress - "200" 


android 
< InageView 


android 


android 


«/LinearLayout > 
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:thumb = "(Qdrawable/ic launcher" /> 


:id="@ + id/imageView" 
android: 
android: 
:src = "@drawable/ic_launcher" 
android: 
android: 


layout_width = "200dp" 
layout_height = "200dp" 


layout_gravity = "center" 
scaleType = "fitXY" /> 


代码 文件 : codes\04\4. 1\SeekBarDemo\res\ layout\activity_main. xml 


以 上 界面 代码 非常 简单 ,只 是 在 界面 中 从 上 而 下 放置 了 一 个 拖 动 条 以 及 一 个 用 于 显示 
图 片 的 ImageView , 主 程序 的 代码 如 下 : 


package cn. edu. hstc. seekbardemo. activity; 


import android. app. Activity; 


import android. content. Context; 


import android. os. Bundle; 


import android. view. WindowManager; 


import android. widget. ImageView; 


import android. widget.LinearLayout; 
import android. widget. SeekBar; 
import android. widget. SeekBar. OnSeekBarChangeListener; 


public class MainActivity extends Activity ( 


private SeekBar seekBar; // 声 明 一 个 SeekBar Xj & 

private ImageView imageView; // 声 明 一 个 InageView Xj 2 

private int width; // 声 明 一 个 int 类 型 的 变量 ,用 于 存放 当前 手机 屏幕 宽度 
(QOverride 


protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 


setContentView(R.layout.activity main); 


// 接 下 来 两 行 代码 获取 了 手机 屏幕 的 宽度 
WindowManager wm = (WindowManager) MainActivity. this. getSystemService (Context. 


WINDOW SERVICE); 
width - 


wn. getDefaultDisplay().getWidth(); 


// 加 载 界面 代码 中 的 SeekBar 和 ImageView 对 象 


seekBar 


= (SeekBar) MainActivity. this. findViewById(R. id. seekBar); 


imageView = (ImageView) MainActivity. this. findViewById(R. id. imageView); 
//?H SeekBar 对 象 设 置 OnSeekBarChangeListener 监听 器 并 重 写 onProgressChanged 方法 


seekBar. 


setOnSeekBarChangeListener(new OnSeekBarChangeListener() { 


@Override 
public void onStopTrackingTouch(SeekBar seekBar) { 


) 


(QOverride 
public void onStartTrackingTouch(SeekBar seekBar) ( 
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) 


(2 Override 
public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) ( 
// 将 当前 的 拖 动 条 的 数组 progress 作为 LayoutParams 构造 器 参数 
LinearLayout. LayoutParams layoutParams9 = new LinearLayout. LayoutParams 
(progress, progress); 
// 使 图 片 居中 显示 
layoutParams9.leftMargin = (width — progress) / 2; 
// 为 ImageView 设置 LayoutParams, 实现 图 片 大 小 由 progress 控制 
imageView. setLayoutParams(layoutParams9); 


np; 


代码 文件 : codes\04\4. 1\SeekBarDemo\cn\edu\hstc\activity\MainActivity. java 


在 该 主 程序 代码 中 ,为 SeekBar 设置 了 OnSeekBarChangeListener 监听 器 并 重 写 了 
实现 将 1J progress 值 ,也 就 是 拖 动 滑 块 后 拖 动 条 的 数值 作为 





onProgressChanged 方法 





图 片 的 width 与 height {É ,并 且 通 过 获取 的 当前 手机 屏幕 宽度 以 及 progress 值 控制 使 图 片 
居中 显示 。 
将 应 用 部 署 在 模拟 器 上 ,运行 效果 如 图 4.6 所 示 。 


fà Fl @ 6:35am 





图 4.6 使 用 SeekBar 控制 图 片 大 小 
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4.1.6 评分 组 件 的 介绍 与 应 用 


在 很 多 网 站 中 ,我 们 经 常 可 以 看 到 用 户 打分 的 情况 ,比如 天 猫 买 家 给 商品 评分 ,那么 在 
Android 应 用 中 ,该 如 何 实现 用 户 参 与 评分 呢 ? 这 时 候 只 需要 使 用 RatingBar 这 个 评分 组 
件 就 能 轻松 解决 问题 了 。 

RatingBar 作为 SeekBar 的 一 种 扩展 ,在 用 法 和 功能 上 都 与 后 者 十 分 相似 ,它们 都 允许 
用 户 通过 拖 动 来 改变 进度 ,只 是 评分 组 件 RatingBar 的 默认 效果 为 若干 个 星星 ,用 于 代表 等 
级 ,当然 ,也 可 以 通过 设置 RatingBar 的 style 属性 来 自 定义 其 显示 效果 。 

RatingBar 支持 如 表 4. 3 所 示 的 XML 属性 。 

表 4.3 RatingBar 支持 的 XML 属性 


属性 名 称 描 x 
android;isIndicator ”设置 该 RatingBar 是 否 允 许 用 户 改 变 其 值 true 为 不 允许 ,此 时 将 作为 指示 器 使 用 
androidinumStars 。” 显示 的 星星 数量 ,必须 是 一 个 整 型 值 ,如 100 
android: rating 设置 默认 的 星 级 ,必须 是 浮 点 类 型 ,如 1.2 
android: stepSize 设置 每 次 最 少 需要 改变 多 少 个 星 级 ,必须 是 浮 点 类 型 ,如 1.2 





如 果 该 RatingBar 是 允许 用 户 改 变 其 值 的 ,那么 为 了 响应 用 户 的 操作 ,可 以 为 
RatingBar 绑 定 一 个 OnRatingBarChangeListener 监听 器 。 下 面 通过 一 个 实例 来 演示 星 级 
评分 控件 的 功能 和 用 法 。 

实例 : 使 用 RatingBar 让 用 户 参 与 评分 。 界 面 代 码 如 下 : 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
xmlns:tools = "http://schemas. android. com/tools" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:background = "(à android:color/black" 
android:orientation = "vertical" > 


< TextView 
android:id- "@ + id/txt show" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:paddingLeft = "5dp" 
android:paddingTop = "10dp" 
android:textColor = "(Qandroid:color/white" 
android:text = "您 的 评分 是 : 5 分 " /> 


< RatingBar 
android:id- "@ + id/ratingBar" 
android:layout_width = "wrap content" 
android:layout height = "wrap content" 
android:paddingTop = "5dp" 
android:max- "5" 
android:progress = "5" 
android:numStars - "5" 
android:stepSize = "0.5" /> 


«/LinearLayout > 
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代码 文件 : codes\04\4.1\RatingBarDemo\res\layout\activity main. xml 
package cn. edu. hstc. ratingbardemo. activity; 


import android. app. Activity; 

import android. os. Bundle; 

import android. widget. RatingBar; 

import android. widget. RatingBar. OnRatingBarChangeListener; 
import android. widget. TextView; 


public class MainActivity extends Activity ( 
(2 Override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
final TextView showView = (TextView) MainActivity. this. findViewById(R. id. txt. show) ; 
RatingBar ratingBar = (RatingBar) MainActivity. this. findViewById(R. id. ratingBar); 


// 为 RatingBar 绑 定 OnRatingBarChangeListener 监听 器 ， 
// 并 在 onRatingChanged 方法 中 实现 将 当前 的 RatingBar 数组 作为 分 数 显 示 出 来 
ratingBar. setOnRatingBarChangeListener(new OnRatingBarChangeListener() { 
(OQ Override 
public void onRatingChanged(RatingBar ratingBar, float rating, boolean fromUser) ( 
showView. setText(" 您 的 评分 是 : ”+ String.valueOf(rating) + "4j"); 


np; 


代码 文件 : codes\04\4. 1\RatingBarDemo\cn\edu\hstc\activity\MainActivity. java 


将 应 用 部 署 在 模拟 器 上 ， 





I 效果 如 图 4.7 Bros. 


DM &3 1:49rm 





图 4.7 用 户 评分 软件 
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4.1.7. 选项 卡 
选项 卡 TabHost 是 一 个 已 经 过 时 的 组 件 , 现 ga € 22» 


在 已 经 不 建议 使 用 了 , 有 其 他 组 件 蔡 代 了 
TabHost, 不 过 这 里 还 是 需要 对 其 进行 一 个 简单 的 
介绍 ,以 便 在 某 些 简单 的 场合 使 用 它 。 

TabHost 是 一 个 容器 ,而 容器 中 装 的 就 是 一 
个 一 个 的 Tab 标签 页 ,每 个 标签 页 相当 于 获得 了 
一 个 与 外 部 容器 相同 大 小 的 组 件 摆 放 区 域 ,这 样 ， 
每 个 Tab 都 对 应 了 一 个 独立 的 布局 ,从 而 使 一 个 
Activity 对 应 了 多 个 功能 布局 。 例 如 ,许多 手机 系 
统 都 会 在 同一 个 窗口 用 多 个 标签 页 来 显示 包括 
“未 接 来 电 ”“ 已 接 来 电 ”“ 已 拨 电 话 ” 的 通话 记录 。 

TabHost 提供 了 如 下 两 个 方法 来 创建 选项 
卡 、 添 加 选项 卡 : 

newTabSpec(String tag) 一 一 创建 选项 卡 ; 

æ addTab (TabHost. TabSpec tabSpec) — 


添加 选项 卡 。 
下 面 通过 一 个 实例 来 演示 如 何 TabHost 组 Hy 


件 , 运 行 效果 如 图 4.8 所 示 。 E 
实例 : 使 用 TabHost。 主 界面 代码 如 下 : 图 4.8 使 用 TabHost 示 例 


History 


< TabHost xmlns:android = "http://schemas. android. com/apk/res/android" 
android: id = "(Zandroid:id/tabhost" 
android:layout width = "match parent" 
android:layout height = "match parent" » 


< RelativeLayout 
android:layout width = "fill parent" 
android:layout height - "fill parent" » 


<! -一 TabWidget 组 件 id 值 不 可 变 --> 

< TabWidget 
android: id = "@android: id/tabs" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout alignParentBottom = "true" > 

«/Tabiiidget > 


<! —— FrameLayout 布局 ,id 值 不 可 变 --> 

< FrameLayout 
android: id = "(Zandroid:id/tabcontent" 
android:layout width- "fill parent" 
android:layout height - "fill parent" 
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android:layout above = "@android: id/tabs" > 
</FrameLayout > 


</RelativeLayout > 


</TabHost > 
代码 文件 : codes\04\4.1\TabHostDemo\res\layout\activity_main. xml 


本 实例 中 还 需要 四 个 界面 文件 ,用 于 存放 每 个 标签 页 所 对 应 的 布局 ,由 于 比较 简单 ,这 
里 只 给 出 其 中 一 个 布局 界面 ,其 他 布局 文件 可 参考 本 书 配 套 资 源 中 的 demo 完整 代码 。 


<?xml version = "1.0" encoding = "utf - 8"?> 

< RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 


android:orientation = "vertical" > 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
androii 
android:layout centerInParent = "true" 
android:text = "Scan" /> 





:textSize = "20sp" 





«/RelativeLayout > 
代码 文件 : codes\04\4. 1VTabHostDemoVresMayoutVactivity scan. xml 


主 程序 代码 如 下 : 


package cn. edu. hstc. tabhostdemo. activity; 


import android. app. TabActivity; 
import android. content. Intent; 
import android. os. Bundle; 
import android. widget. TabHost; 


public class MainActivity extends TabActivity ( 
private TabHost tabHost; 
private Intent scan, history, generator, setting; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
setContentView(R. layout.activity main); 
tabHost = getTabHost(); 
initIntent(); 
addSpec() ; 


[ux 
* 初始 化 各 个 Tab 标签 对 应 的 intent, 即 单 击 各 个 标签 页 跳 转 到 的 页 面 
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x*/ 
private void initIntent() { 
scan = new Intent(this, ScanActivity. class); 
history = new Intent(this, HistoryActivity. class); 
generator = new Intent(this, GeneratorActivity. class); 
setting = new Intent(this, SettingActivity. class); 


} 


private void addSpec() { 
tabHost. addTab(this. buildTabSpec(" Scan", "Scan", R. drawable. scan selected item, 


scan)); 

tabHost. addTab(this. buildTabSpec ( "History", "History", R. drawable. history selected | 
item, history)); 

tabHost. addTab(this. buildTabSpec(" Generator", "Generator", R. drawable. generator _ 
selected item, generator)); 

tabHost. addTab( this. buildTabSpec("Setting", "Setting", R. drawable. setting selected 
item, setting)); 


) 

/ xx 
* 创建 标签 项 
* @param tabName 标签 标识 
* (param tabLable 标签 文字 
* (param icon 标签 图 标 


* @param content 标签 对 应 的 内 容 
* (Qreturn 
ay 
private TabHost. TabSpec buildTabSpec(String tabName, String tabLable, int icon, Intent 
content) ( 
return tabHost 
. newTabSpec( tabName) 
. setIndicator(tabLable, 
getResources( ) . getDrawable( icon) ). setContent(content); 


代码 文件 : codes\04\4.1\TabHostDemo\cn\edu\hstc\activity\MainActivity. java 


通过 以 上 主 程序 代码 可 以 看 出 ,使 用 TabHost 的 一 般 步骤 如 下 : 

(D 在 布局 界面 中 定义 TabHost 组 件 ,为 该 组 件 定 义 TabWidget 标签 项 ,并 定义 了 一 个 
FrameLayout 用 于 存放 各 个 标签 页 ; 

@ Activity 继承 TabActivity; 

© 调用 TabActivity 的 getTabHost() 方 法 获取 TabHost 对 象 ; 

CD 为 TabHost 创建 选项 卡 、 添 加 选项 卡 。 

需要 指出 的 是 ,上 面 的 代码 通过 setContent(Intent intent) 方 法 来 设置 标签 页 的 内 容 ， 
也 就 是 单 击 标签 项 所 对 应 的 布局 。 


4.1.8 滚动 视图 
当 布局 中 的 内 容 非常 多 ,已 经 容纳 不 下 时 ,这 时 将 会 用 到 垂直 滚动 视图 Scroll View 或 
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水 平 深 动 视图 HorizontalScrollView, ScrollView 和 HorizontalScrollView 的 功能 基本 相 
似 , 作 用 都 是 为 普通 组 件 或 布局 添加 滚动 条 ,不 同 之 处 在 于 前 者 添加 的 是 垂直 滚动 条 ,而 后 
者 添加 的 是 水 平 滚动 条 。 

上 述 两 个 组 件 都 只 能 包含 一 个 组 件 , 但 它们 都 不 是 传统 意义 上 的 容器 ,都 只 是 为 其 他 容 
器 添加 滚动 条 ,并 且 ,ScrollView 5 HorizontalScrollView nf EJ EHRE. 

下 面 通过 一 个 实例 来 进一步 了 解 ScrollView 跟 HorizontalScrollView。 

实例 : 结合 ScrollView 和 HorizontalScrollView 实现 横竖 两 方向 都 可 滚动 。 

< ScrollView xmlns:android = "http://schemas. android. com/apk/res/android" 

xmlns:tools = "http://schemas. android. com/tools" 


android: layout width= "match parent" 
android:layout height = "match parent" > 


< HorizontalScrollView 
android:layout width- "fill parent" 
android:layout height = "wrap content" > 


< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
vertical" » 





android:orientation = 


< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(2drawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
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android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InmageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< ImageView 
android: layout width= "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(ddrawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" » 


< ImageView 
android: layout width= "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
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android 


< ImageView 


android: 
android: 
android: 


« InageView 
android 
android 


< InageView 


android: 
android: 
:src = "(drawable/ic launcher" /> 


android 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


«/LinearLayout > 
< LinearLayout 


:src= "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 





:layout width = "wrap content" 
:layout height = "wrap content" 
android: 


src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content. 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


android:layout width- "fill parent" 


android:layout height = "wrap content" 


android:orientation = "horizontal" > 


« InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 
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< ImageView 
android:layout width= "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 





android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


« ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
android:layout width- "fill parent" 
:layout height = "wrap content" 
android:orientation = "horizontal" > 





androii 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


97 


98 ' Android 应 用 开发 从 入 门 到 精通 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 





« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "()drawable/ic launcher" /> 


« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 








< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 


< ImageView 
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android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(ddrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< ImageView 
android:layout width- "wrap content" 
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android: 
android: 


« InageView 


android: 
android: 
:src = "(Zdrawable/ic launcher" /> 


android 


< InageView 
android 


< ImageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


«/LinearLayout > 
< LinearLayout 


layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


:layout width = "wrap content" 
android: 
android: 


layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
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android:orientation = "horizontal" > 


< ImageView 
android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android: src = "()drawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Üdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 
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</LinearLayout > 
<LinearLayout 


android:layout width= "fill parent" 
android:layout height = "wrap content" 
android:orientation - "horizontal" » 


« InageView 
android 
android 
android 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


:layout width = "wrap content" 
:layout height = "wrap content" 
:src= "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout_width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 





layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 
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< ImageView 
android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


« ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 


< ImageView 
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android: 
android: 
android: 


« InageView 


android: 


android 

android 
«/LinearLayout > 
< LinearLayout 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 


:layout height - "wrap content" 
:src = "(Qdrawable/ic launcher" /> 


android:layout width- "fill parent" 
android:layout height = "wrap content" 


android:orientation = "horizontal" » 


« InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
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android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


« InageView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 





< ImageView 
android: layout_ width= "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width - "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
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android: src = "@drawable/ic_launcher" /> 
< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 
« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 
« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 
«/LinearLayout > 


< LinearLayout 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


< InageView 


android: 
android: 
android: 


« InageView 
android 
android 
android 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


«/LinearLayout > 
< LinearLayout 
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layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


:layout width = "wrap content" 
:layout height = "wrap content" 
:src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height - "wrap content" 
src = "(Üdrawable/ic launcher" /> 


android:layout width- "fill parent" 


android:layout height = "wrap content" 


android:orientation = "horizontal" > 


< ImageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


107 


108 


Android 应 用 开发 从 入 门 到 精通 


< ImageView 


android: 
android: 
:src= "(Adrawable/ic launcher" /> 


android 


< InageView 
android 
android 
android 


« InageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


«/LinearLayout > 
< LinearLayout 


layout width- "wrap content" 
layout height = "wrap content" 


:layout width = "wrap content" 
:layout height 
:src= "(Qdrawable/ic launcher" /> 





wrap content" 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


android:layout width- "fill parent" 


android:layout height = "wrap content" 


android:orientation = "horizontal" > 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< ImageView 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


第 4 章 ”Android 高 级 界面 组 件 


android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Q)drawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "()drawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
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android: 
android: 


« InageView 


android: 
android: 
:src= "(Zdrawable/ic launcher" /> 


android 


< InageView 
android 


< ImageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


«/LinearLayout > 
< LinearLayout 


layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


:layout width = "wrap content" 
android: 
android: 


layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


android:layout width- "fill parent" 


android:layout height = "wrap content" 


android:orientation = "horizontal" > 


« InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
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android: src = "@drawable/ic_launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 





« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< ImageView 
android: layout width= "wrap content" 
android:layout height = "wrap content" 
android: src = "(drawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 
«/LinearLayout > 
< LinearLayout 
id:layout width- "fill parent" 
layout height = "wrap content" 
android:orientation = "horizontal" > 





< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 
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< ImageView 


android: 
android: 
android: 


« InageView 
android 
android 
android 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


«/LinearLayout > 
< LinearLayout 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


:layout width = "wrap content" 
:layout height = "wrap content" 
:src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 





layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


« InageView 


android: 
android: 
android: 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 
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< ImageView 
android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 





« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 
«/LinearLayout >< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< ImageView 
android:layout width- "wrap content" 
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android: 
android: 


« InageView 


android: 
android: 
:src = "(Zdrawable/ic launcher" /> 


android 


< InageView 
android 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


« InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


«/LinearLayout > 
< LinearLayout 


layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


:layout width = "wrap content" 
android: 
android: 


layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 


src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height - "wrap content" 


src = "(Üdrawable/ic launcher" /> 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
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android:orientation = "horizontal" > 


« InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: src = "(Zdrawable/ic launcher" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


« InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:src = "(drawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android:src = "(Qdrawable/ic launcher" /> 


< ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:src = "(Zdrawable/ic launcher" /> 
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</LinearLayout > 
< LinearLayout 


android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation - "horizontal" » 


« InageView 
android 
android 
android 


< InageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


< InageView 


android: 
android: 
android: 


< ImageView 


android: 
android: 
android: 


:layout width = "wrap content" 
:layout height = "wrap content" 
:src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width= "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 





layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width = "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Qdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 


layout width- "wrap content" 
layout height = "wrap content" 
src = "(Üdrawable/ic launcher" /> 
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< ImageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android: src = "(Qdrawable/ic launcher" /> 
«/LinearLayout > 
«/LinearLayout > 
«/HorizontalScrollView- 


«/ScrollView» 
代码 文件 : codes\04\4. 1VScrollViewDemoVresMlayoutVactivity main. xml 


主 程序 代码 比较 简单 ,只 是 通过 setContent View BMA 5:00 e» 
(R. layout. activity_main) 方 法 中 将 界面 文件 布局 “ERAITETTEET 


1 

1 
| 
ti 


于 全 人 和 人 人 人 全 全: 
2223222223 
ü 
^ 


设置 为 该 应 用 启动 界面 。 
将 应 用 部 署 在 模拟 器 上 ,运行 效果 如 图 4.9 ro] ro] Pa 
所 示 。 > . 
当 在 水 平方 向 上 左右 滑动 界面 时 ,将 会 看 到 QE 


有 一 条 水 平 滚动 条 出 现 , 并 且 界面 可 以 左右 移动 ， 
看 到 更 多 的 水 平方 向 的 小 机 器 人 ; 当 在 垂直 方向 
上 下 滑动 界面 时 ,将 会 看 到 一 条 垂直 滚动 条 ,并 且 
界面 可 以 上 下 移动 ,也 可 以 看 到 更 多 的 垂直 方向 
的 小 机 器 人 。 这 就 是 滚动 视图 给 应 用 带 来 的 
效果 。 


4.1.9 列表 视图 


列表 视图 ListView 是 一 个 非常 好 用 的 组 件 ,在 
Android 应 用 中 也 非常 常见 ,比如 通讯 录 就 是 一 个 
列表 视图 ,腾讯 QQ 的 好 友 列 表 也 是 一 个 列表 视图 。 
可 见 ,ListView 在 手机 系统 中 使 用 非常 广泛 。 

ListView 以 垂直 列表 的 形式 显示 所 有 列表 图 4.9 滚动 视图 的 使 用 
项 ,并 且 能 够 根据 数据 的 长 度 进行 自 适 应 显示 ,也 
就 是 说 ,通常 因为 数据 多 ,ListView 是 自动 加 了 滚动 条 的 ,创建 ListView 有 两 种 方法 : 

名 加 载 界面 文件 中 的 ListView 对 象 并 给 ListView 设置 适配器 Adapter, 即 数据 源 ; 

名 让 Activity 继承 ListActivity。 

ListView 提供 了 如 表 4.4 所 示 的 XML 属性 。 


表 4.4 ListView 所 支持 的 XML 属性 


ji299922202322 
3220200222203 
i29222239222223224 


iz 





XML 属性 说 明 
android:choiceMode 设置 ListView 的 选择 行为 
android: divider 设置 列表 项 的 分 隔 条 ( 既 可 用 颜色 分 隔 , 也 可 用 Drawable 分 隔 ) 
android: dividerHeight 设置 分 隔 条 的 高 度 


android: entries 指定 一 个 数组 资源 作为 生成 ListView 的 数据 源 
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下 面 通过 一 个 实例 来 介绍 如 何 使 用 ListView, 在 该 实例 中 ,将 分 别 介绍 在 界面 文件 中 直接 
H ListView 绑 定 数据 源 ,在 主 程序 中 通过 Array Adapter, SimpleAdapter, SimpleCursorAdapter. 
通过 Activity 继承 ListActivity 这 几 种 方式 来 创建 ListView。 

实例 : ListView 的 各 种 创建 方式 。 应 用 的 启动 界面 代码 如 下 : 


<?xml version = "1.0" encoding = "utf - 8"?> 

<LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width= "fill parent" 
android:layout height = "fill parent" 
android:orientation = "vertical" > 


« Button 


android: 
:layout width- "fill parent" 
android: 
itext = "在 界面 代码 中 直接 为 ListView 指定 填充 内 容 的 数组 " 
android: 


android 


android 


« Button 
android 


< Button 


android: 
android: 
android: 
android: 


« Button 


android: 
android: 
android: 
android: 


« Button 


android: 
android: 
android: 
android: 


«/LinearLayout > 


id- "(à + id/btn entries" 
layout height = "wrap content" 


layout marginTop = "5dp" /> 


:id- "(9 + id/btn ArrayAdapter" 
android: 
android: 
android: 


layout width- "fill parent" 
layout height = "wrap content" 
text = "ArrayAdapter 作为 ListView 的 适配器 " /> 


id= "@ + id/btn SimpleAdapter" 

layout width- "fill parent" 

layout height = "wrap content" 

text = "SinpleAdapter 作为 ListView 的 适配器 " /> 


id- "(à + id/btn SimpleCursorAdapter" 

layout width = "fill parent" 

layout height = "wrap content" 

text = "SinpleCursorAdapter 作为 ListView 的 适配器 " /> 


id= "@ + id/btn listActivity" 

layout width- "fill parent" 

layout height = "wrap content" 

text = "基于 ListActivity 实现 列表 " /> 


代码 文件 : codes\04\4. 1\ListViewDemo\res\layout\activity_main. xml 


在 该 界面 代码 文件 中 ,在 一 个 垂直 方向 的 线性 布局 中 从 上 而 下 放置 了 五 个 按钮 ,各 个 按 
钮 代表 了 不 同 的 创建 ListView 的 方式 , 接 下 来 在 主 程序 中 为 各 个 按钮 添加 时 间 监 听 器 , 代 


码 如 下 : 


package cn. edu. hstc. listviewdemo. activtiy; 
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import android. app. Activity; 

import android. content. Intent; 

import android. os. Bundle; 

import android. view. View; 

import android. widget. Button; 

import cn. edu. hstc. listviewdemo. activity. R; 


public class MainActivity extends Activity ( 
private Button entriesBtn; 
private Button arrayAdapterBtn; 
private Button simpleAdapterBtn; 
private Button simpleCursorAdapterBtn; 
private Button testListActivityBtn; 


(QOverride 

public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
initButton(); 


private void initButton() ( 
// 加 载 界面 代码 中 各 个 Button 按钮 
entriesBtn = (Button) findViewById(R. id.btn entries); 
arrayAdapterBtn = (Button) findViewById(R. id. btn ArrayAdapter); 
simpleAdapterBtn = (Button) findViewById(R. id. btn SimpleAdapter); 


simpleCursorAdapterBtn = (Button) findViewById(R. id. btn SimpleCursorAdapter); 


testListActivityBtn - (Button) findViewById(R. id. btn listActivity); 


// 为 各 个 按钮 添加 时 间 监 听 器 

entriesBtn. setOnClickListener(btnListener); 
arrayAdapterBtn. setOnClickListener(btnListener); 
simpleAdapterBtn. setOnClickListener(btnListener); 
simpleCursorAdapterBtn. setOnClickListener(btnListener); 
testListActivityBtn. setOnClickListener(btnListener); 


// 创 建 一 个 时 间 监 听 器 类 ,在 该 类 中 根据 按钮 的 Id 为 按钮 添加 不 同 的 动作 ， 
// 即 跳 转 到 不 同 的 二 级 界面 中 ,展示 不 同 的 创建 ListView 方式 
private View. OnClickListener btnListener = new View.OnClickListener() { 
(2 Override 
public void onClick(View v) { 
Intent intent = null; 
switch (v.getId()) ( 
case R. id. btn entries: 
intent = new Intent(MainActivity.this, EntriesActivity.class); 
MainActivity.this.startActivity(intent); 
break; 
case R. id. btn ArrayAdapter: 


intent = new Intent(MainActivity.this, ArrayAdapterActivity.class); 
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MainActivity.this.startActivity(intent); 
break; 
case R. id. btn SimpleAdapter: 
intent = new Intent(MainActivity.this, SimpleAdapterActivity.class); 
MainActivity.this. startActivity(intent); 
break; 
case R. id. btn SimpleCursorAdapter: 
intent = new Intent(MainActivity.this, SimpleCursorAdapterActivity.class); 
MainActivity.this. startActivity(intent); 
break; 
case R. id. btn listActivity: 
intent = new Intent(MainActivity.this, TestListActivity.class); 
MainActivity. this. startActivity(intent); 


break; 
default: 
break; 
) 
) 
}; 
j 
代码 文件 : codes\04\4. 1\ListViewDemo\cn\edu\hstc\activity\MainActivity. java 
将 程序 部 署 在 模拟 器 上 ,可 以 看 到 如 图 4. 10 所 示 的 运行 界面 。 





BAA 6:23am 


在 界面 代码 中 直接 为 ListView 指 定 坊 充 内 容 的 数 
组 


ArrayAdapter 作 为 ListView 的 适配器 


SimpleAdapter 作 为 ListView 的 适 配 


SimpleCursorAdapter 作 为 ListView 的 适 配 : 


基于 ListActivity 实 现 列表 





图 4. 10 ListViewDemo 运行 启动 界面 
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单 击 启动 界面 中 的 第 一 个 Button 按钮 ,应 用 将 会 跳 转 到 EntriesActivity 界面 ,该 界面 
的 布局 如 下 : 


<?xml version = "1.0" encoding = "utf - 8"?» 
< LinearLayout xmlns :android = "http://schemas. android. com/apk/res/android" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:orientation = "vertical" > 


<! -- 直接 使 用 数组 资源 给 出 列表 项 --> 
<! 为 ListView 指定 颜色 分 隔 线 , 并 制定 分 隔 线 高 度 --> 


<ListView 





android:layout width= "fill parent" 
android:layout height = "wrap content" 
android:entries = "(Jarray/sports" 
android:divider = "(3 color/yellow" 
android:dividerHeight = "0. 5dp" /> 


</LinearLayout > 
代码 文件 : codes\04\4.1\ListViewDemo\res\layout\activity_entries. xml 
在 该 界面 代码 中 ,通过 android:entries— " 2array/sports" 直接 使 用 数组 作为 ListView 
的 列表 项 ,这 里 用 到 了 数组 次 以 需要 新 建 一 个 value 文件 ,代码 如 下 : 


Ii sports ,所 





<?xml version= "1.0" encoding = "utf - 8"?> 


<resources> 
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< string- array name = "sports"» 

< item > 篮球 </item> 

< item >J EK «/ item» 

< item > 乒乓 球 </item> 

< item > 排球 </item> 

< item > 足球 </item> 

< item » BE EK «/ item» 
«/string- array» 


«/resources > 
代码 文件 : codes\04\4. 1NListViewDemoV 

resWaluesVsports. xml 

EntriesActivity. java 的 代码 非常 简单 ,只 是 通 
过 setContentView ( ) 方法 将 activity _ listview _ 
entries. xml 作为 其 界面 布局 ,这 里 就 不 展示 了 。 

二 级 界面 EntriesActivity 的 运行 效果 如 图 4. 11 
所 示 。 

单 击 启动 界面 的 第 二 个 按钮 ,将 跳 转 到 
ArrayAdapterActivity 界面 中 。 在 该 界面 中 ,使 用 
ArrayAdapter 作为 ListView 的 适配器 ,界面 布局 代 
码 与 activity_listview_entries. xml 类 似 ,只 是 没有 为 图 4.11 EntriesActivity 运行 效果 
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ListView 指定 数组 资源 ,这 里 就 不 进行 展示 了 。 下 面 给 出 ArrayAdapterActivity. java 的 代码 内 
容 , 如 下 所 示 : 


package cn. edu. hstc. listviewdemo. activtiy; 


import java. util. ArrayList; 


import java. util. List; 


import android. app. Activity; 

import android. os. Bundle; 

import android. widget. ArrayAdapter; 
import android. widget. ListView; 


import cn. edu. hstc. listviewdemo. activity. R; 


public class ArrayAdapterActivity extends Activity { 
(QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity listview arrayadapter); 
// 加 载 界面 布局 中 的 ListView 对 象 
ListView arrayAdapterListView = (ListView) ArrayAdapterActivity. this. findViewById 
(R. id.listview arrayadapter); 
// 将 getData( ) 方 法 返回 的 数组 包装 在 一 个 ArrayAdapter 中 
ArrayAdapter < String > arrayAdapter = new ArrayAdapter < String >(this, android.R. 
layout.simple list item 1, getData()); 
// 为 ListView 设置 Adapter 
arrayAdapterListView. setAdapter(arrayAdapter); 


private List < String» getData() { 
List < String» data = new ArrayList < String^(); 
data. add(" — HWX"); 
data. add( "水浒 传 "); 
data.add(" 西 游记 "); 
data. add( "红楼梦 "); 


return data; 


} 


上 面 的 程序 创建 了 一 个 ArrayAdapter. 创建 ArrayAdapter 时 必须 指定 一 个 
textViewResourceld ,该 参数 决定 每 个 列表 项 的 外 观 样 式 , 如 下 所 示 : 

辟 simple_list_item_1 一 一 每 个 列表 项 都 是 一 个 普通 的 TextView; 

名 simple_list_item_2 一 一 每 个 列表 项 都 是 一 个 普通 的 TextView ,但 字体 略 大 ; 

如 simple_list_item_checked 一 一 每 个 列表 项 都 是 一 个 已 勾 选 的 列表 项 ; 

如 simple_list_item_multiple_choice 一 一 每 个 列表 项 都 是 带 多 选 框 的 文本 s 

如 simple_list_item_single_choice 一 一 每 个 列表 项 都 是 带 单 选 按钮 的 文本 。 
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二 级 界面 ArrayAdapterActivity 的 运行 效果 
如 图 4. 12 所 示 。 

单 击 启 动 界面 中 的 第 三 个 按钮 ,将 跳 转 到 使 
用 SimpleAdapter 作为 ListView 适配器 的 二 级 界 
面 SimpleAdapterActivity, 其 界面 布局 与 Array 
AdapterActivity 的 界面 布局 类 似 , 这 里 也 不 进行 “区 起 24 局 
展示 。 这 里 关注 的 是 SimpleAdapterActivity 的 实 
现 ,代码 如 下 所 示 : 西游 记 


à RI] a 6:37 





package cn. edu. hstc. listviewdemo. activtiy; 


import java. util. ArrayList; 
import java. util. HashMap; 
import java. util. List; 
import java. util. Map; 


import android. app. Activity; 

import android. os. Bundle; 

import android. widget. ListView; 

import android. widget. SimpleAdapter; 

import cn. edu. hstc. listviewdemo. activity. R; 





public class SimpleAdapterActivity extends Activity { K 4.12 ArrayAdapterActivity 运行 效果 
(QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity listview simpleadapter); 
// 加 载 界面 中 的 ListView 对 象 
ListView listView = (ListView) SimpleAdapterActivity. this. findViewById (R. id. 
listview simpleadapter); 


// 这 里 R.layout.item listview simpleadapter 自 定 义 了 ListView 的 列表 项 
// 其 中 new String[ ]{"image"，"title"，"info" } 与 getData 方法 中 的 map 对 象 的 key 一 一 对 应 
SimpleAdapter adapter = new SimpleAdapter(this, getData(), R. layout. item listview 
simpleadapter, 
new String[]("image", "title", "info"), new int[](R. id. image news, R. id. txt_ 
title, R. id. txt info]); 
listView. setAdapter(adapter); 


private List « Map < String, Object >> getData() { 
List <Map< String, Object?» list = new ArrayList < Map < String, Object >>( ) ; 
Map < String, Object» map = new HashMap < String, Object»(); 


map. put("image", R.drawable. image001); 

map. put("title", "K - BPE 3-1 JL XC S8 3 EE"); 

map.put("info"，" 苏 牙 与 内 少 破 门 , 梅 西 策动 进 球 , 巴 萨 10 年 4 夺 欧 冠 ."); 
list. add(map); 
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map = new HashMap < String, Object»(); 

map. put("image", R. drawable. image002) ; 

map. put("title", "AJEBK3EiE if Xx JL 8i fe FEE") ; 

map.put("info"，" 宝 宝 带 着 小 免 帽 子 , 甜美 出 境 , 网 友 : 这 以 后 得 多 美 ."); 
list.add(map); 


map = new HashMap < String, Object»(); 

map. put("image", R.drawable. image003) ; 

map.put("title"，" 高 考 作文 结束 EXA A A"); 

nap. put("info", "2015 年 全 国 高 考 大 幕 拉 开 , 还 记得 当年 高 考 时 的 情景 么 ?"); 
list.add(map); 

return list; 


) 


以 上 程序 展示 了 使 用 SimpleAdapter 创建 ListView 的 方式 ,在 代码 中 ,可 以 看 到 ,程序 
使 用 item_listview_simpleadapter. xml 自 定 义 了 列表 项 的 展示 .该 文件 代码 如 下 : 


<?xml version= "1.0" encoding = "utf - 8"?> 

<LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width= "fill parent" 
android:layout height - "fill parent" 
android:orientation = "horizontal" > 


< ImageView 
androi ="@ *id/image news" 
android:layout width = "80dp" 
android:layout height = "50dp" 
android:scaleType = "fitXY" 
android:layout margin = "5px" /> 





< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android:orientation = "vertical" » 


< TextView 
android:id- "(à + id/txt title" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:textColor = " # FFFFFFFF" 
android: textSize = "22px" /> 


< TextView 
android:id- "(2 + id/txt info" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:paddingTop = "3dp" 
android:textColor = " # FFFFFFFF" 
android:textSize = "16px" /> 


«/LinearLayout > 


«/LinearLayout > 


通过 以 上 代码 可 以 看 出 ,SimpleAdapterActivity 
的 ListView 的 列表 项 包含 了 一 个 ImageView 作 
为 新 闻 图 片 ,显示 在 界面 最 左边 ,在 图 片 的 右边 ， 
从 上 而 下 , 显示 了 一 条 新 闻 的 标题 和 简介 。 
SimpleAdapterActivity 的 运行 效果 如 图 4. 13 
所 示 。 

单 击 启 动 界面 的 第 四 个 按钮 ,将 跳 转 到 
SimpleCursorAdapterActivity 界面 中 ,其 布局 与 
SimpleAdapterActivity 的 布局 类 似 , 这 里 也 不 展 7 
我 们 主要 关注 的 是 SimpleCursorAdapterActivity 的 
实现 代码 ,实现 如 下 : 








package cn. edu. hstc. listviewdemo. activtiy; 


import android. app. Activity; 

import android. database. Cursor; 

import android. os. Bundle; 

import android. provider. Contacts. People; 
import android. widget.ListAdapter; 

import android. widget.ListView; 

import android. widget. SimpleCursorAdapter; 
import cn. edu. hstc. listviewdemo. activity. R; 


(à SuppressWarnings("deprecation") 
public class SimpleCursorAdapterActivity extends 
Activity ( 

private ListView listView; 


@Override 


protected void onCreate(Bundle savedInstanceState) { 


super. onCreate( savedInstanceState); 
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LULILSE LIUM LEE I 


考 大 项 拉 开 ,还 记得 当年 高 考 时 的 


SimpleAdapterActivity 运行 效果 


setContentView(R.layout.activity listview simplecursoradapter); 


// 加 载 界面 文件 中 的 ListView 对 象 


listView = (ListView) SimpleCursorAdapterActivity. this. findViewById(R. id. listview_ 


simplecursoradapter); 


// 查 询 手机 通讯 录 


Cursor cursor = getContentResolver().query(People.CONTENT URI, null, null, null, null); 


// 将 查询 结果 cursor 作为 SimpleCursorAdapter 的 填充 数据 源 
ListAdapter listAdapter = new SimpleCursorAdapter(this, android. R. layout. simple_ 


expandable list item 1, cursor, 


new String[ ](People. NAME), new int[ ] (android. R. id. text1]); 


// 为 ListView 对 象 设置 适配器 
listView. setAdapter(listAdapter); 
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由 于 程序 需要 查询 手机 通讯 录 . 所 以 必须 在 AndroidManifest. xml 中 为 程序 添加 权限 : 





< uses - permission android:name = "android. permission. READ CONTACTS" > 
SimpleCursorAdapterActivity 的 运行 效果 如 图 4. 14 所 示 。 


DM &3 7:194 


ListViewDemo 





图 4.14 SimpleCursorAdapterActivity 运行 效果 


单 击 启动 界面 的 最 后 一 个 按钮 , 跳 转 到 TestListActivity 界面 ,该 界面 不 需要 指定 布局 
文件 。TestListActivity. java 文件 代码 如 下 : 


package cn. edu. hstc. listviewdemo. activtiy; 


import android. app. ListActivity; 
import android. os. Bundle; 
import android. widget. ArrayAdapter; 


public class TestListActivity extends ListActivity { 
(QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
String[] arr = ("Java", "Android" ,"HTML5"}; 
ArrayAdapter < String» adapter = new ArrayAdapter < String »(this, android. R. layout. 
simple list item multiple choice, arr); 
//ListActivity 类 所 带 方法 ,设置 该 窗 体 显示 列表 
setListAdapter(adapter); 
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从 以 上 代码 可 以 看 出 ,程序 并 没有 为 TestListActivity 设置 一 个 布局 ,而 是 通过 
setListAdapter 方法 直接 让 该 窗口 显示 一 个 列表 ,这 是 因为 ListActivity 有 它 自己 默认 的 布 
局 , 即 列表 ,而 TestListActivity 继承 自 ListActivity, 所 以 并 不 一 定 要 为 其 指定 布局 文件 。 
实际 上 ,我 们 依旧 可 以 通过 setContentView 方法 为 继承 了 ListActivity 的 Activity 指 
定 一 个 自 定义 的 布局 界面 ,但 这 个 自 定义 的 布局 中 需要 包含 一 个 id JJ " (9 十 id/android: 
list” 的 ListView, 这 是 一 种 固定 写法 ,开发 者 只 需 按照 约定 来 编写 代码 就 可 以 了 。 例 如 ,以 


下 代码 文件 : 

















«?xnl version = "1.0" encoding = "utf - 8"?> 

< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout widths "fill parent" 
android:layout height = "fill parent" 
android:orientation = "vertical" > 


< ListView 
android: id = "(à + id/android: list" 
android:layout_width = "fill_parent" 
android:layout height = "wrap content" 
android:divider = "(Gcolor/white" 
android:dividerHeight = "0. 5dp" /> 





</LinearLayout > 
代码 文件 : codes\04\4. 1\ListViewDemo\res\layout\activity listactivity.xml 


TestListActivity 的 运行 界面 如 图 4. 15 所 示 。 


"ame 4:55 pm 





图 4. 15 TestListActivity 运行 效果 
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4.2 使 用 对 话 框 


对 话 框 虽然 在 程序 中 不 是 必 备 的 .但 是 用 好 对 话 框 能 使 应 用 增色 不 少 , 因 为 采用 对 话 框 
可 以 大 大 地 增强 应 用 的 友好 性 。 在 这 个 用 户 体 验 至 上 的 时 代 , 好 的 界面 就 是 成 功 的 一 半 。 
所 以 ,要 学 好 对 话 框 的 使 用 ,并 在 适当 的 地 方 灵活 运用 。 比 较 常 用 的 场景 是 : 用 户 登录 、 网 
络 正在 下 载 . 下 载 成 功 或 失败 的 提示 。 当 然 还 有 很 多 场景 可 以 用 到 ,比如 短信 来 了 .电池 没 
电 了 等 ,一 般 都 需要 用 到 弹出 对 话 框 。 

以 下 用 一 个 示例 来 演示 对 话 框 的 使 用 ,运行 应 用 后 ,在 主 界面 会 显示 几 个 Button, 单 击 
不 同 的 Button 会 弹出 不 同 的 对 话 框 。 

在 主 界面 中 ,从 上 至 下 放置 了 六 个 Buuton 按钮 ,分 别 对 应 不 同 风格 的 对 话 框 ,界面 布 
局 文件 比较 简单 ,此 处 不 再 列 出 代码 , 详 见 代码 文件 : codes\04\4. 2\DialogDemoNres\ 
layout\activity_main. xml, 


将 程序 部 署 于 模拟 器 上 ,运行 效果 如 图 4. 16 所 示 。 
BA 2:40 


简单 对 话 框 





简单 列表 对 话 框 


单 选 列表 对 话 框 


多 选 列表 对 话 框 


登录 功能 对 话 框 


加 载 框 





图 4.16 对 话 框 应 用 主 界面 
接着 ,我 们 来 看 看 主 界面 对 应 的 Java 代码 ,其 中 ,应 首先 在 onCreate 方法 中 初始 化 各 个 
控件 并 设置 监听 器 ,此 处 MainActivity 类 实现 OnClickListener 接口 ,其 对 象 将 被 设置 为 各 
个 Button 控件 的 事件 监听 器 ,关键 代码 如 下 : 


private Button simpleBtn, simpleListBtn, radioListBtn, checkBoxListBtn, 
inputBtn, loadBtn; 
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@Override 

protected void onCreate( Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity main); 
initButton(); 


private void initButton() ( 
simpleBtn - (Button) findViewById(R. id.btn simple); 
simpleBtn. setOnClickListener(MainActivity.this); 


simpleListBtn - (Button) findViewById(R. id.btn simple list); 
simpleListBtn. setOnClickListener(MainActivity. this); 


radioListBtn = (Button) findViewById(R. id. btn radio list); 
radioListBtn. setOnClickListener(MainActivity. this); 
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checkBoxListBtn = (Button) findViewById(R. id.btn checkbox list); 


checkBoxListBtn. setOnClickListener(MainActivity. this); 


inputBtn = (Button) findViewById(R. id.btn input); 
inputBtn. setOnClickListener(MainActivity.this); 


loadBtn = (Button) findViewById(R. id.btn load); 
loadBtn. setOnClickListener(MainActivity. this); 


(QOverride 
public void onClick(View v) ( 

switch (v.getId()) ( 

case R. id. btn simple: 
createSimpleDialog(); 
break; 

case R. id.btn simple list: 
createSimpleListDialog(); 
break; 

case R. id. btn radio list: 
createRadioListDialog(); 
break; 

case R. id. btn checkbox list: 
createCheckBoxListDialog(); 
break; 

case R. id. btn input: 
createInputDialog(); 
break; 

case R. id. btn load: 
createLoadDialog(); 
break; 

default: 
break; 
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单 击 界面 中 的 第 一 个 按钮 ,将 会 看 到 弹出 如 图 4. 17 所 示 的 对 话 框 , 该 对 话 框 也 是 
Android 最 原始 最 简单 的 对 话 框 。 





BMA 3:12 ow 





B] 27 


确认 退出 吗 ? 





图 4.17 简单 对 话 框 
第 一 个 按钮 “简单 对 话 框 ?的 功能 实现 的 关键 代码 如 下 : 
/ xx 


* 创建 简单 对 话 框 
*/ 
protected void createSimpleDialog() { 
AlertDialog.Builder builder = new Builder(MainActivity. this); 
builder. setIcon(R. drawable. simple dialog icon); 
builder. setTitle(" 提 示 "); 
builder. setMessage( "确认 退出 吗 ?"); 
builder. setPositiveButton(" 确 认 ",， new DialogInterface. OnClickListener() ( 
@Override 
public void onClick(DialogInterface dialog, int which) { 
dialog.dismiss(); 
MainActivity. this. finish(); 
} 
H; 
builder.setNegativeButton(" Hifi", new DialogInterface. OnClickListener() { 
GOverride 
public void onClick(DialogInterface dialog, int which) { 
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dialog.dismiss(); 
} 
n; 
builder.create(). show(); 


) 

单 击 弹出 框 的 “确定 ?按钮 ,弹出 框 消失 ,接着 退出 主 界面 ; 单 击 弹 出 框 的 “取消 ”按钮 ， 
弹出 框 消失 。 

从 创建 简单 对 话 框 的 方法 中 ,我 们 知道 ,要 想 创建 一 个 简单 的 对 话 框 ,可 以 执行 如 下 步 又 : 

* 通过 AlertDialog. Builder builder — new Builder (context) 语句 首先 生成 

AlertDialog. Builder 的 对 象 ,这 样 就 可 以 开始 构造 AlertDialog; 
* builder. setIcon(R. drawable. simple_dialog_icon) 语 句 给 AlertDialog 预 设 值 一 个 图 
标 ,这 里 预 设 的 是 simple dialog icon. png 这 张 图 片 ; 

* builder. setTitle(" 提 示 ") 语 句 为 AlertDialog 预 设 一 个 标题 ; 

* builder. setMessage( "确认 退出 吗 ?") 语 句 为 AlertDialog 预 设 了 提示 消息 ; 

。 builder. setPositiveButton() 方 法 设置 弹出 框 确定 按钮 的 一 些 属性 ,第 一 个 参数 为 按 
钮 上 显示 出 来 的 内 容 , 第 二 个 参数 为 DialogInterface. onClickListener() 监 听 器 对 
象 ,这 个 监听 器 与 2. 1 节 中 介绍 的 UI 控件 第 一 种 响应 方法 类 似 ,该 监听 器 实现 
onClick() 回 调 方法 , 当 单 击 Dialog 的 按钮 时 系统 回调 该 方法 ,一 般 将 对 话 框 的 处 理 
逻辑 写 到 回调 方法 中 ; 
builder. setNegativeButton() 方 法 和 builder. 
setPositiveButton() 方 法 对 应 ,用 于 设置 
取消 按钮 的 一 些 属性 ; 

。 预 设 好 所 有 关于 Dialog 的 属性 后 ,执行 

builder. create(). show() 后 将 生成 一 个 配 
置 好 的 Dialog; 

AlertDialog 是 Dialog 的 一 个 直接 子 类 ， (o) 简单 列表 对 话 框 
AlertDialog 也 是 Android 系统 中 最 常用 的 对 话 框 
之 一 。 一 个 AlertDialog 可 以 有 两 个 或 三 个 
Button。 不 能 直接 通过 AlertDialog 的 构造 方法 来 
生成 一 个 AlertDialog ,一 般 是 使 用 它 的 一 个 内 部 
静态 类 AlertDialog. Builder 来 构造 的 。 

单 击 主 界面 中 的 第 二 个 按钮 ,弹出 如 图 4. 18 
所 示 对 话 框 。 

生成 简单 列表 对 话 框 的 关键 代码 如 下 : 


/xx 
* 创建 简单 列表 对 话 框 
*/ 


protected void createSimpleListDialog() { 


final Builder b = new AlertDialog. 图 4.18 简单 列表 对 话 框 
Builder(MainActivity. this); 


b. setTitle(" 简 单列 表 对 话 框 "); 
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b. setItems (new String[ ] ("5 (&", "#6", "黑色 "}, new DialogInterface. 
OnClickListener() ( 
@Override 
public void onClick(DialogInterface dialog, int which) { // 该 方法 的 which 参数 代 
表 用 户 单 击 了 哪个 列表 项 
Switch (which) ( 
case 0: 
simpleListBtn. setTextColor(R. color. green); 
break; 
case 1: 
simpleListBtn. setTextColor(R. color. yellow); 
break; 
case 2: 
simpleListBtn. setTextColor(R. color. black); 
break; 
default: 
break; 
} 
} 
H; 
b.create().show(); 
} 


上 面 的 程序 中 调用 AlertDialog. Builder 的 setItems 方法 为 对 话 框 设置 了 多 个 列表 项 ， 
此 处 生成 的 只 是 三 个 普通 列表 项 。 单 击 任 意 一 个 列表 项 ,将 为 主 界面 的 “简单 列表 对 话 框 ” 
按钮 设置 对 应 的 字体 颜色 。 

单 击 主 界面 中 的 第 三 个 按钮 “ 单 选 列表 对 话 框 ”, 将 弹出 如 图 4. 19 所 示 对 话 框 。 
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单 选 列表 对 


图 4.19 单 选 列表 对 话 框 
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生成 单 选 列 表 对 话 框 的 关键 代码 如 下 : 


/xx 
* 创建 单 选 列表 对 话 框 
*/ 
protected void createRadioListDialog() { 
final Builder b = new AlertDialog. Builder(MainActivity. this); 
b. setTitle(" 单 选 列表 对 话 框 "); 
b. setSingleChoiceItems (new String[ ] {" 绿 色 ",， " d (&", "黑色 "}, 1, new 
DialogInterface.OnClickListener() ( 
(QOverride 
public void onClick(DialogInterface dialog, int which) { 
Switch (which) { 
case 0: 
radioListBtn. setTextColor(R. color. green); 
break; 
case 1: 
radioListBtn. setTextColor(R. color. yellow); 
break; 
case 2: 
radioListBtn. setTextColor(R. color. black); 
break; 
default: 
break; 
) 
) 
D; 
b. setPositiveButton(" WEE", null); 
b.create(). show() ; 
) 


上 面 的 程序 中 调用 AlertDialog. Builder 的 setSingleChoiceltems 方法 为 对 话 框 设置 了 
多 个 单 选 列表 项 。 单 击 任 意 一 个 列表 项 ,将 为 主 界面 的 “ 单 选 列表 对 话 框 ”按钮 设置 对 应 的 
字体 颜色 。 

单 击 主 界面 中 的 “多 选 列表 对 话 框 ” 按 钮 ,弹出 如 图 4. 20 所 示 对 话 框 。 

创建 多 选 列表 对 话 框 的 关键 代码 如 下 : 


/xx 
* 创建 多 选 列表 对 话 框 
*/ 
protected void createCheckBoxListDialog() { 
final boolean[] checkStatus = new boolean[] (true, false, true); 
final String[] sports = new String[] {" 篮 球 ", "羽毛球 "," 律 球 "}; 
final Builder b = new AlertDialog.Builder(MainActivity. this); 
b. setTitle(" 多 选 列表 对 话 框 "); 
// 下 面 的 setMultiChoiceItens 方法 中 的 第 二 个 参数 checkStatus 设置 了 默认 勾 选 的 列表 项 
b.setMultiChoiceItems(sports, checkStatus, new DialogInterface. OnMultiChoiceClickListener() { 
(2 Override 
public void onClick(DialogInterface dialog, int which, boolean isChecked) { 
String result = "您 喜欢 的 运动 为 : "; 
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for (inti = 0; i< checkStatus. length; i++) { 
if (checkStatus[i]) ( 
result *- sports[i] * ","; 
} 
} 
Toast. makeText(MainActivity. this, result. substring(0, result. length() 一 
1), 3000). show() ; 
) 
n; 
b. setPositiveButton( "确定 ",， null); 
b. create( ). show( ); 


} 
上 面 的 程序 中 调用 AlertDialog. Builder 的 setMultiChoiceltems 方法 为 对 话 框 设置 了 
多 个 多 选 列表 项 。 单 击 任意 一 个 列表 项 ,将 弹出 类 似 “ 您 喜欢 的 运动 为 篮球 、 羽 毛 球 ”" 这 样 的 
提示 。 
单 击 主 界面 上 的 登录 功能 对 话 框 ,弹出 如 图 4. 21 所 示 对 话 框 。 
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图 4.20 多 选 列表 对 话 框 图 4.21 登录 对 话 框 


创建 登录 对 话 框 的 关键 代码 如 下 : 


m 
* 创建 登录 对 话 框 
*/ 
protected void createInputDialog() { 
LayoutInflater inflater = LayoutInflater. from(MainActivity. this); 
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final View textEntryView = inflater.inflate(R. layout. input dialog layout, null); 
final Builder b = new AlertDialog. Builder(MainActivity.this); 
b.setTitle(" Hl P ER"); 
b. setView(textEntryView); 
b. setPositiveButton(" 确 定 "，new DialogInterface. OnClickListener() { 
(QOverride 
public void onClick(DialogInterface arg0, int argl) { 
EditText nameEdt = (EditText) textEntryView. findViewById(R. id. edt. name) ; 
EditText passEdt - (EditText) textEntryView. findViewById(R. id. edt pass); 
if (nameEdt. getText(). toString(). trim(). equals("") || passEdt. getText(). 
toString().trim().equals("")) ( 
Toast. makeText (MainActivity. this, "用 户 名 或 密码 不 能 为 空 !"，3000). 
show(); 
} else { 
Toast.makeText(MainActivity.this, "您 按 了 确定 键 "，3000). show(); 
} 
} 
D; 
b. setNegativeButton(" 取 消 "，new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface arg0, int argl) { 
Toast.makeText(MainActivity.this, "您 按 了 取消 键 "，3000). show(); 
} 
D; 
b.create(). show() ; 
) 


通过 以 上 代码 可 以 看 出 ,创建 该 登录 对 话 框 的 方法 与 前 面 创建 其 他 对 话 框 的 方法 类 似 ， 
但 是 这 个 方法 中 没有 设置 Dialog 的 message. 而 是 直接 给 Dialog 设置 了 一 个 定制 化 的 View 
实例 。 

。 通过 LayoutInflater 类 的 inflate 方法 ,可 以 将 一 个 XML 的 布局 变 成 一 个 View 

实例 ; 

。 通过 b. setView (textEntryView) 语 句 将 自 定义 的 View 放置 到 Dialog 中 去 ,这 是 

Dialog 的 精髓 所 在 ,这 里 的 textEntryView 和 input. dialog layout. xml 这 个 文件 定 
义 的 布局 相关 联 。input_dialog_layout. xml 的 布局 文件 比较 简单 ,此 处 不 再 列 出 。 
读者 可 以 参考 codes\04\4. 2\DialogDemo\res\layout\ input_dialog_layout. xml 
文件 。 

如 果 用 户 名 或 密码 两 个 或 其 中 一 个 为 空 的 时 候 , 单 击 “ 确 定 ” 按 钮 ,就 会 提示 “用 户 名 或 
密码 不 能 为 空 !1”, 否 则 将 提示 “您 按 了 确定 键 ”; 而 当 用 户 单 击 “ 取 消 ” 按 钮 ,就 会 提示 “您 按 
了 取消 键 ”。 

单 击 主 界面 中 的 加 载 框 按钮 ,弹出 如 图 4. 22 所 示 对 话 框 。 

创建 加 载 框 的 关键 代码 如 下 : 


/xx 


* 创建 加 载 框 
x/ 
protected void createLoadDialog() ( 


136 


b 


a 


Android 应 用 开发 从 入 门 到 精通 


Q 正在 下 载 歌 曲 


a HHR.. 





4.22 MRE 


ProgressDialog dialog = new ProgressDialog(MainActivity. this); 
dialog. setTitle(" 正 在 下 载 歌 曲 ..."); 
dialog. setMessage( "请 稍 候 ..."); 
dialog. show( ); 
} 


通过 以 上 程序 可 以 看 出 ,创建 加 载 框 和 创建 其 他 弹出 框 不 一 样 ,不 需要 通过 
AlertDialog. Builder 这 个 内 部 静态 类 进行 构造 ,而 是 直接 使 用 ProgressDialog 类 的 构造 方 
法 进行 构造 。ProgressDialog 是 AlertDialog 的 一 个 子 类 ,同样 通过 setTitle() 方 法 设置 标 
题 以 及 通过 setMessage() 设 置 内 容 。 


4.3 Toast 和 Notification 的 应 用 


前 面 介绍 的 Dialog 对 话 框 其 实 已 经 起 到 向 用 户 提示 消息 的 作用 ,但 其 更 多 用 于 当 程序 
有 大 量 消息 .图 片 需要 向 用 户 提示 时 ,Android 系统 还 提供 了 一 套 友 好 的 、 更 轻 量 级 的 对 话 
框 供 程序 只 有 少量 信息 要 向 用 户 旦 现时 使 用 ,这 种 机 制 不 会 打 断 用 户 的 当前 操作 ,可 谓 非常 
巧妙 ,这 就 是 Android 的 消息 提示 。 

下 面 通过 一 个 例子 来 演示 使 用 Toast 和 Notification 两 种 方式 提示 用 户 。 该 实例 在 主 
界面 自 上 而 下 放置 三 个 Button 控件 ,用 来 供用 户 单 击 进 入 不 同 的 功能 。 该 主 界面 代码 
如 下 : 
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< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width- "match parent" 
android:layout height = "match parent" 
android:orientation = "vertical" > 


< Button 
android:id- "(2 + id/btn simple toast" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout marginTop = "5dip" 
android:text = "普通 的 Toast 消息 提示 " /> 


« Button 
android:id- "(à + id/btn image toast" 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
android:text = " 带 图 片 的 Toast 消息 提示 " /> 


« Button 
android:id- "(8 + id/btn create notification" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = "创建 Notification 消息 提示 " /> 


< Button 
android:id- "@ + id/btn delete notification" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:text = "删除 Notification 消息 提示 " /> 





«/LinearLayout > 


该 程序 部 署 于 模拟 器 上 ,运行 效果 如 图 4. 23 Bros o 


该 实例 主 程序 代码 中 关于 初始 化 界面 中 的 控件 以 及 实现 各 个 控件 的 业务 代码 块 如 下 


所 示 : 
private Button simpleToast, imageToast, createNotification, deleteNotification; 


@Override 

protected void onCreate( Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity main); 


simpleToast = (Button) findViewById(R. id.btn simple toast); 
simpleToast. setOnClickListener(MainActivity. this); 


imageToast - (Button) findViewById(R. id.btn image toast); 
imageToast. setOnClickListener(MainActivity. this); 


createNotification = (Button) findViewById(R. id. btn create notification); 
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createNotification. setOnClickListener(MainActivity. this); 


deleteNotification = (Button) findViewById(R. id.btn delete notification); 
deleteNotification. setOnClickListener(MainActivity. this); 


(2 Override 
public void onClick(View v) ( 
switch (v.getId()) ( 
case R. id. btn simple toast: 
createSimpleToast(); 
break; 
case R. id.btn image toast: 
createImageToast(); 
break; 
case R. id. btn create notification: 
createNotification(); 
break; 
case R. id. btn delete notification: 
deleteNotification(); 
break; 
default: 
break; 


) 

单 击 界面 中 的 第 一 个 按钮 ,将 弹出 如 图 4. 24 所 示 的 提示 

BAO 3:21 
普通 的 Toast 消 息 提示 





普通 的 Toast 消 息 提示 


带 图 片 的 Toast 消 息 提 示 


Notification 消 息 提示 


这 是 一 个 简单 的 Toast 提 示 





图 4.23 Android 消息 提示 实例 主 界面 图 4.24 普通 Toast 提示 消息 
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实现 弹出 该 普通 Toast 提示 消息 的 关键 代码 如 下 : 


/x** 
* 创建 普通 的 Toast 消息 提示 
*/ 
private void createSimpleToast() { 
/ [nakeText 方法 中 的 第 三 个 参数 的 作用 是 设置 该 Toast 提示 消息 的 持续 时 间 
//Toast. LENGTH_SHORT 表示 短 时 间 显示 ,Toast. LENGTH. LONG 表示 长 时 间 显 示 
// 也 可 以 自 定 义 秒 数 , 比如 将 参数 设置 为 3000, 表示 该 Toast 提示 消息 持续 时 间 为 3 秒 
// 最 后 一 点 要 说 的 是 ,不 要 忘 了 最 后 的 . show() ,这样 才能 将 该 Toast. 显示 出 来 
Toast. makeText (MainActivity. this, "这 是 一 个 简单 的 Toast 提示 "， Toast. LENGTH_LONG). show( ) ; 
} 
上 面 程序 中 关于 实现 弹出 普通 Toast 提示 消息 的 代码 比较 简单 ,只 需要 通过 Toast 的 
-个 静态 方法 即 可 构造 该 Toast。 下 面 直接 进入 带 图 片 的 Toast 提示 消息 的 学 习 , 单 击 主 
界面 中 的 第 二 个 Button 按钮 ,弹出 如 图 4. 25 所 示 的 提示 。 
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图 4.25 带 图 片 的 Toast 提示 消息 


实现 带 图 片 的 Toast 提示 消息 的 关键 代码 如 下 : 


/xx 
* 创建 带 图 片 的 Toast 消息 提示 
x/ 

private void createImageToast() { 
Toast toast = Toast. makeText (MainActivity. this, "这 是 一 个 带 图 片 的 Toast 提示 "，Toast. 

LENGTH LONG); 
toast. setGravity(Gravity.CENTER, 0, 0); 
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// 获 取 Toast 提示 里 原 有 的 View 

View toastView = toast.getView(); 

// 创 建 一 个 InageView 

ImageView image = new ImageView(MainActivity.this); 

image. setImageResource(R. drawable. toast); 

// 创 建 一 个 LinearLayout 容器 

LinearLayout layout = new LinearLayout(MainActivity.this); 

// 向 layout 中 添加 图 片 . 原 有 的 View 

layout. addView(image); 

layout. addView(toastView); 

// 将 该 layout. 作为 该 Toast 消息 提示 所 展示 的 View 

toast. setView(layout); 

toast. show() ; 

} 

上 面 代码 已 经 有 相关 注释 ,其 中 最 核心 的 代码 就 是 获取 Toast 自 带 的 View, 并 重新 为 
该 Toast 设 定 一 个 新 的 View。 

从 以 上 两 种 Toast 提示 消息 的 学 习 可 以 看 出 ,Toast 是 一 种 非常 方便 的 提示 消息 框 , 它 

具有 如 下 两 个 特点 : 

* Toast 提示 消息 不 会 获得 焦点 

* Toast 提示 消息 过 一 段 时 间 会 自动 消失 。 

从 以 上 程序 也 可 了 解 到 ,开发 Toast 提示 消息 的 步骤 也 是 非常 简单 的 ,具体 步骤 如 下 : 

所 调用 Toast 的 构造 器 或 makeText() 静 态 方法 创建 一 个 Toast 对 象 ; 

名 调用 Toast 的 方法 来 设置 该 消息 提示 的 对 齐 方式 、 页 边 距 等 ; 

el JH Toast 的 showO 〇 方法 将 它 显示 出 来 ; 

名 如 果 需 要 开发 带 图 片 的 Toast, 则 需要 调用 setView() 方 法 设置 该 Toast 显示 的 
View 组 件 , 该 方法 允许 开发 者 自 定义 自己 的 Toast 显示 内 容 , 但 一 般 建议 需要 显示 
图 片 的 复杂 提示 则 使 用 Dialog 对 话 框 来 完成 。 

单 击 主 界面 上 的 第 四 个 按钮 ,启动 Notification, 将 会 在 手机 状态 栏 显示 “启动 其 他 

Activity 的 通知 ”, 过 一 会 儿 标题 会 消失 ,通知 图 标 继续 显 示 在 状态 栏 上 ,如 图 4. 26 所 示 。 
实现 创建 Notification 通知 的 关键 代码 如 下 : 

/** 

* 创建 Notification 
*/ 
private void createNotification() { 
// 创 建 一 个 启动 其 他 Activity 的 Intent 
Intent intent = new Intent(MainActivity.this, NotificationActivity.class); 
PendingIntent pi = PendingIntent.getActivity(MainActivity.this, 0, intent, 0); 
// 创 建 一 个 Notification 
Notification notify = new Notification(); 
// 为 Notification 设置 图 标 ,该 图 标 显示 在 状态 栏 
notify.icon = R.drawable.ic launcher; 
// 为 Notification 设置 文本 内 容 , 该 图 标 显示 在 状态 栏 
notify. tickerText = "启动 其 他 Activity 的 通知 "; 
// 为 Notification 设置 发 送 时 间 
notify.when = System.currentTimeMillis(); 
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[ 启动 其 他 Activity 的 通知 


普通 的 Toast 消 息 提示 普通 的 Toast 消 息 提 示 


带 图 片 的 Toast 消 息 提示 带 图 片 的 Toast 消 息 提示 


启动 Notification 消 息 提示 局 动 Notification 消 息 近 示 


删除 Notifcation 消 息 提示 fills Notification; e tf zr 





(a) 状态 栏 显示 通知 图 标 与 标题 (b) 状态 栏 只 虹 直 通知 图 标 
图 4.26 状态 栏 的 两 种 情况 
// 为 Notification 设置 声音 
notify. defaults = Notification.DEFAULT SOUND; 
// 为 Notification 设置 震动 .默认 闪光 灯 
notify.defaults = Notification. DEFAULT ALL; 
// 设 置 事件 消息 
notify. setLatestEventInfo(MainActivity. this, "普通 通知 "," 点 击 查 看 "，pi); 
// 获 取 系 统 的 NotificationManager 服务 
NotificationManager notificationManager = (NotificationManager) getSystemService ( NOTIFICATION - 
SERVICE); 
// 发 送 通知 
notificationManager.notify(0x1123, notify); 


} 


从 以 上 代码 可 以 看 出 ,创建 一 个 Notification 并 不 难 , 只 需要 通过 以 下 步骤 即 可 : 

切 通 过 构造 器 创建 一 个 Notification 对 象 ; 

e VE Notification 对 象 设置 各 个 属性 ,比如 图 标 .文本 标题 等 等 

名 调用 getSystemService NOTIFICATION | SERVICE) 77 i 3K BUR £ 

服务 ; 

名 通过 NotificationManager 发 送 Notification. 

代码 中 有 一 行 代 码 用 于 设置 Notification 的 事件 信息 ,该 行 代码 为 notify. 
setLatestEventInfo( MainActivity. this. "普通 通知 "," 点 击 查 看 ", pi) ,第 四 个 参数 为 一 个 
跳 转 到 其 他 Activity 的 Intent 对 象 , 表 示 当 用 户 单 击 该 Notification 时 会 启动 该 Intent 对 应 
的 程序 。 





的 NotificationManager 
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将 状态 栏 向 下 拖 动 将 看 到 Notification 的 详情 ,如 图 4. 27 所 示 , 单 击 该 详情 ,将 会 跳 到 
NotificationMessageActivity 页 面 ,如 图 4. 28 所 示 。 该 页 面 所 对 应 的 界面 布局 以 及 主 程序 


比较 简单 ,此 处 不 再 袭 述 。 
而 
ToastAndNotificationDemo 


我 是 通知 消息 





图 4.27 Notification 通知 详情 图 4.28 跳 转 至 其 他 页 面 


单 击 程序 主 界面 的 第 四 个 按钮 ,删除 Notification, 将 会 直接 删除 该 条 Notification 通 
知 ,此 时 状态 栏 中 对 应 的 Notification 图 标 也 会 消失 。 关 键 代码 如 下 : 
/ xx% 
* 删除 Notification 
*/ 
private void deleteNotification() { 


NotificationManager notificationManager = (NotificationManager) getSystemService ( NOTIFICATION _ 
SERVICE) ; 


notificationManager. cancel(0x1123); 
} 
以 上 代码 通过 获取 系统 的 NotificationManager 服务 ,然后 通过 cancel() 方 法 即 可 取消 
该 条 Notification. cancel ( ) 方 法 需要 传人 一 个 参数 ,该 参数 值 与 启动 Notification 时 
notificationManager. notify(0x1123. notify) 语 句 的 第 一 个 参数 值 对 应 ,此 处 都 是 0x1123， 
通过 该 标识 的 传人 来 通知 Android 取消 对 应 的 Notification 通知 。 


4.4 使 用 菜 
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受到 手机 屏幕 大 小 的 制约 ,Android 应 用 的 菜单 并 不 会 像 桌 面 应 用 那样 直接 展示 出 来 ， 
Android 程序 中 的 菜单 默认 是 看 不 见 的 ,只 有 当 用 户 单 击 手机 上 的 MENU 键 时 ,系统 才 会 





展示 该 应 用 所 带 的 菜单 。 菜单 在 Android 系统 中 的 应 用 还 是 比较 常见 的 。 





Android 平 台 提 供 了 三 种 菜单 的 实现 方式 , 即 选项 菜单 (OptionMenu)、 子 菜单 


(SubMenu)、 上 下 文 菜单 (ContextMenu)。 


下 面 通过 一 个 简单 的 应 用 来 介绍 如 何 开发 菜单 程序 ,程序 主 界面 布局 文件 如 下 : 


< RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android:layout width = "match parent" 
android:layout height = "match parent" 
android:padding = "5dip" > 


< Button 
android:id- "(à + id/btn pay" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout alignParentRight - "true" 
android:text = "长 按 选择 .…." /> 


<EditText 
android:id- "(à + id/edt pay" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout toLeftOf = "(3id/btn pay" 
android:editable = "false" 
android: text = "付款 方式 " /> 


</RelativeLayout > 
代码 文件 : codes\04\4. 4N 

MenuDemo\res\layout\activity_main. xml 

将 程序 部 署 于 Android 模拟 器 上 ,看 到 如 图 4. 29 
所 示 运 行 结果 。 

从 运行 效果 上 看 ,该 界面 上 没有 显示 任何 控 
件 ,这 个 与 上 面 的 布局 界面 有 些 不 一 样 ,这 是 因为 
在 主 程序 中 将 界面 上 的 EditText 控件 以 及 Button 
控件 给 隐藏 了 。 代 码 片 段 如 下 : 

// 声 明 主 界面 上 的 文本 输入 控件 以 及 Button 控件 


private EditText payEdt; 
private Button payBtn; 





// 为 每 个 上 下 文 菜单 定义 一 个 标识 图 4.29 菜单 应 用 


final int MENU1 = 0X111; 
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final int MENU2 = 0X112; 
final int MENU3 - 0X113; 


// 定 义 显示 或 隐藏 控件 的 子 菜单 项 标识 
final int EVISIBIE = 0x114; 
final int EINVISIBLE = 0x115; 


// 定 义 普通 菜单 项 标识 
final int BSUBMIT = 0x116; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
// 通 过 资源 ID 加 载 界面 控件 
payEdt = (EditText) findViewById(R. id. edt pay); 
payBtn = (Button) findViewById(R. id.btn pay); 


// 隐 藏 界面 上 的 EditText 控件 以 及 Button 按钮 
payEdt. setVisibility(View. INVISIBLE) ; 
payBtn. setVisibility(View. INVISIBLE) ; 


// 为 Button 按钮 注册 上 下 文 菜单 
registerForContextMenu(payBtn) ; 
上 


通过 红色 框 中 的 两 行 代码 将 布局 上 的 两 个 控件 一 并 隐藏 掉 , 接 下 来 ,程序 将 实现 一 个 带 
有 两 个 子 菜单 的 选项 菜单 以 及 一 个 不 带子 菜单 的 普通 选项 菜单 ,代码 片段 如 下 : 


/ xx 
* 创建 选项 菜单 和 子 菜单 
*/ 
@Override 
public boolean onCreateOptionsMenu(Menu menu) { 
// 向 menu 中 添加 显示 或 隐藏 支付 方式 的 子 菜单 
SubMenu vis = menu.addSubMenu(" 显 示 或 隐藏 支付 方式 "); 
// 设 置 菜单 头 的 标题 
vis. setHeaderTitle(" 选 择 是 否 显示 支付 方式 "); 
vis.add(0, EVISIBIE, 0, "显示 "); 
vis.add(0, EINVISIBLE, 0, "隐藏 "); 
// 向 menu 中 添加 普通 菜单 项 
menu. add(0, BSUBMIT, 0, "提交"); 
return super. onCreateOptionsMenu( menu) ; 


) 

以 上 代码 片段 重 写 了 Activity 类 中 的 onCreateOptionsMenu( Menu menu) 方 法 ,该 方 
法 实现 用 户 按 下 手机 上 的 menu 按键 ,将 会 在 手机 屏幕 正 下 方 出 现 两 个 选项 菜单 ,这 个 也 是 
menu 菜单 的 默认 显示 位 置 , 单 击 “ 显 示 或 隐藏 支付 方式 ”这 个 菜单 项 ,将 会 弹出 一 个 带 着 两 
个 选项 的 子 菜单 ,供用 户 选择 “显示 ”或 隐藏”; 另外 一 个 menu 菜单 项 是 “提交 ”, 该 菜单 项 
不 带 任何 子 菜单 。 效 果 如 图 4. 30 和 图 4. 31 所 示 。 
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显示 或 隐藏 支付 方式 提交 


图 4.30 Hii menu 底部 出 现 菜单 项 图 4.31 单 击 第 一 个 菜单 项 出 现 了 对 应 的 子 菜单 


此 时 ,我 们 还 并 未 真正 实现 “显示 “隐藏 * 以 及 “提交 ”这 三 个 按钮 的 业务 功能 ,因此 需要 
j Activity 类 中 onOptionsItemSelected( Menultem item) 回 调 方 法 ,方法 根据 各 个 菜单 项 
的 标识 ,实现 不 同 的 操作 ,代码 片段 如 下 : 





/** 
* 选项 菜单 和 子 菜单 被 单 击 后 的 回调 方法 
*/ 


@Override 
public boolean onOptionsItemSelected(MenuItem item) { 
Switch (item.getlItemId()) ( 
case EVISIBIE: 
payEdt. setVisibility(View. VISIBLE) ; 
payBtn. setVisibility(View. VISIBLE); 
break; 
case EINVISIBLE: 
payEdt. setVisibility(View. INVISIBLE); 
payBtn. setVisibility(View. INVISIBLE); 
break; 
case BSUBMIT: 
Toast.makeText(MainActivity.this, "您 单 击 了 普通 菜单 项 ,正在 提交 .…"，Toast. LENGTH -. 
LONG). show() ; 
break; 
default: 
break; 
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return true; 


} 


以 上 程序 实现 单 击 子 菜单 中 的 “显示 ”按钮 ,将 会 实现 显示 界面 上 的 EditText 以 及 
Button 控件 , 单 击 子 菜单 中 的 “隐藏 > ESRB OR 个 控件 ; 用 户 单 击 menu 菜单 项 
“提交 ”, 将 会 弹出 一 个 Toast 消息 ,提示 用 户 正在 提交 。 运 行 效果 如 图 4. 32 和 图 4. 33 所 示 。 
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您 单 击 了 普通 菜单 项 ， 正 在 提交 .，… 


图 4.32 显示 EditText 及 Button 图 4.33 单 击 提交 时 的 Toast 提示 


以 上 主要 介绍 了 如 何 开发 选项 菜单 以 及 子 菜单 。 从 上 面 的 应 用 的 开发 过 程 可 以 看 出 ， 
开发 选项 菜单 以 及 子 菜单 其 实 非 常 简单 ,步骤 如 下 : 

383 onCreateOptionsMenu(Menu menu) 方 法 ,在 该 方法 中 为 menu 添加 选项 a 

以 及 子 菜单 , 即 决定 用 户 按 下 手机 menu 按键 后 在 屏幕 下 方 所 显示 的 菜单 有 哪些 ,i 
方法 最 后 返回 一 个 布尔 类 型 值 ,如 果 返 回 false, 则 不 会 显示 菜单 ; 

E 3 onOptionsItemSelected( Menultem item) 方 法 ,在 该 方法 中 定义 各 个 菜单 项 被 

选中 后 的 动作 事件 ,该 方法 会 在 用 户 选 中 菜单 项 时 被 自动 调用 。 

在 此 需要 向 读者 说 明 的 是 , 按 下 menu 后 的 默认 样式 是 在 屏幕 底部 弹出 一 个 菜单 ,这 个 
菜单 就 叫做 选项 菜单 OptionsMenu., 一 般 情 况 下 ,选项 菜单 最 多 显示 两 排 ,每 排 显示 三 个 菜 
单项 ,这 些 菜 单项 可 以 同时 包含 文字 和 图 标 ,也 被 称 作 Icon Menus, 如 果 多 于 六 项 ,从 第 六 
项 开始 会 被 隐藏 ,在 第 六 项 会 出现 一 个 More 菜单 项 , 单 击 More 才 出 现 第 六 项 及 以 后 的 菜 
单项 ,这 些 菜单 项 也 被 称 为 扩展 菜单 (Expanded Menus). 

除了 上 面 介绍 的 选项 菜单 以 及 子 菜单 ,还 有 另外 一 种 叫做 上 下 文 菜单 (ContextMenu) 
的 菜单 。 接 下 来 将 继续 在 该 实例 上 扩展 ,为 其 开发 上 下 文 菜单 。 首 先 ,来 看 一 下 效果 ,长 按 





ET 
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图 4. 33 中 的 “长 按 选 择 ” 按 钮 ,将 会 弹出 一 个 带 着 三 个 菜单 项 的 菜单 ,该 菜单 就 是 上 下 文 菜 





单 ,如 图 4. 34 所 示 。 
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择 支 付 方式 


网 上 银行 


图 4.34 长 按 弹 出 上 下 文 菜单 
实现 上 下 文 菜单 的 关键 代码 片段 如 下 : 


/ xx 
* 每 次 创建 上 下 文 菜单 时 都 会 触发 该 方法 
*/ 


@Override 


public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) { 


menu. add(0, MENU, 0, "支付 宝 "); 
menu. add(0, MENU2, 0, "IW fh"); 
menu. add(0, MENU3, 0, "RJ E 58£1"); 

// 将 这 三 个 菜单 项 设置 为 单 选 菜单 项 
menu. setGroupCheckable(0, true, true); 
// 设 置 上 下 文 菜单 的 标题 和 图 标 

nenu. setHeaderTitle( "选择 支付 方式 "); 
menu. setHeaderIcon(R. drawable. pay); 

} 


重 写 onCreateContextMenu(ContextMenu menu. View v. ContextMenulnfo menulnfo) J7 
法 ,该 方法 自 定义 上 下 文 菜单 内 容 , 在 该 实例 中 ,我 们 为 上 下 文 菜单 添加 了 三 个 菜单 项 并 设 
置 为 单 选 菜单 项 ,通过 ContextMenu 的 setHeaderTitle() 和 setHeaderIcon() 方 法 分 别 设 置 


了 菜单 的 标题 和 图 标 。 此 时 还 并 未 实现 各 个 菜单 项 的 单 击 事件 ,可 以 通过 重 


onContextItemSelected(Menultem item) 方 法 实现 ,代码 片段 如 下 : 





E 


写 
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/xx 
* 重 写 单 击 菜单 项 时 触发 的 方法 
*/ 
@Override 
public boolean onContextltemSelected(MenuItem item) { 
Switch (item.getItenId()) ( 
case MENU: 
item. setChecked(true); 
payEdt. setText(" X [i] 32"); 
break; 
case MENU2: 
item. setChecked(true); 
payEdt. setText ("IJ sii") ; 
break; 
case MENU3: 
item. setChecked(true); 
payEdt. setText(" 网 上 银行 "); 
break; 
default: 
break; 





} 


return true; 


} 

上 面 程 序 根据 各 个 菜单 项 的 唯一 标识 ,为 各 个 菜单 项 设置 了 选中 时 的 动作 , 即 设置 
EditText 文本 框 内 容 为 相应 的 支付 方式 。 此 时 单 击 图 4. 34 中 的 第 一 个 选项 “支付 宝 ”， 
EditText 里 的 文字 将 变 为 “支付 宝 ”, 效 果 如 图 4. 35 所 示 


tan CJ 4:26 pm 








图 4.35 设置 上 下 文 菜单 选项 选中 事件 
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digi 该 实例 的 上 下 文 菜单 ,可 以 看 出 ,其 开发 步骤 与 开发 选项 菜单 类 似 ,此 处 不 再 
。 至 此 ,我 们 已 学 习 完 了 前 面 所 说 的 三 种 类 型 的 菜单 的 使 用 。 


G 本 章 小 结 


对 于 一 个 手机 应 用 ,用 户 最 直接 的 感受 是 软件 的 界面 ,与 第 3 章 一 样 ,本 音 重 点 介绍 的 
也 是 能 让 软件 与 用 户 实现 良好 的 交互 .能 让 软件 有 一 个 友好 的 界面 的 一 些 控 件 ,包括 自动 完 
成 文本 框 ` 下 拉 列 表 日 期 时 间 选 择 器 .进度 条 与 拖 动 条 、 评 分 组 件 .选项 卡 ,滚动 视图 与 列表 
视图 。 除 此 之 外 ,掌握 使 用 对 话 框 与 菜单 ,也 能 大 大 增加 软件 的 可 交互 性 ,而 用 于 显示 简单 


的 提示 消息 ,并 且 一 段 时 间 后 会 自动 隐藏 的 Toast', 使 用 起 来 十 分 方便 ,也 是 非常 常用 的 一 
种 消息 提示 方式 。 





使 用 资源 文件 | 


查看 Android 项 目 文件 夹 ,可 以 看 到 在 第 二 级 目录 下 有 一 个 叫 res 的 文件 夹 ,该 文件 夹 
中 存放 的 是 Android 应 用 中 使 用 到 的 资源 ,包括 字符 串 资 源 .颜色 资源 .数组 资源 .菜单 资源 
等 ,在 应 用 程序 中 可 以 直接 对 这 些 资源 定义 进行 应 用 。 

除了 res 目录 下 可 以 存放 资源 以 外 ,assets 目录 也 可 用 于 存放 资源 。 一 般 情况 下 ,应 用 
无 法 直接 访问 的 原生 态 资源 将 会 被 放 到 assets H 录 下 ,程序 需要 通过 AssetManager 以 二 
进 制 流 的 形式 来 读 取 资 源 。 而 res 目录 下 的 资源 ,Android SDK 会 在 编译 该 应 用 时 ,自动 在 
R. java 文件 中 为 这 些 资源 创建 索引 ,程序 可 以 直接 通过 res 清单 类 进行 访问 。 

前 面 介绍 的 实例 中 大 多 都 是 直接 将 字符 串 值 直接 写 在 布局 文件 中 或 者 Java 程序 代码 
中 ,其 实 这 是 一 个 不 好 的 编程 习惯 ,现在 通过 本 章 关 于 Android 资源 文件 的 学 习 后 ,应 该 在 
编程 时 将 Android 应 用 会 使 用 到 的 资源 放 在 res 文件 目录 下 并 通过 资源 文件 来 管理 ,然后 
在 布局 文件 或 Java 代码 中 采用 res 清单 类 进行 访问 。 


6.1 资源 的 类 型 和 存储 方式 


Android 资源 包含 了 保存 在 assets 目录 下 无 法 直接 访问 的 原生 资源 以 及 保存 在 res 目 
录 下 通过 R 清单 类 来 访问 的 这 两 种 类 型 的 资源 。 

在 Android 项 目 文件 夹 的 res 目录 下 ,不 同 的 子 目 录 存放 着 不 同类 型 的 应 用 资源 , 表 5. 1 
显示 了 Android 不 同 资源 在 res 目录 下 的 存储 方式 。 


表 5.1 res 目 录 下 各 资源 存储 方式 


目 录 存放 的 资源 
/res/anim/ 存放 定义 补 间 动 画 的 XML 文件 
/res/color/ 存放 定义 不 同 状态 下 颜色 列表 的 XML 文件 
该 目录 下 存放 各 种 位 图 文件 (如 * . png, * . 9. png、* .jpg、*. gif) 等 , 除 此 之 外 还 可 编译 
成 如 下 各 种 Drawable 对 象 的 XML 文件 : 
BitmapDrawable 
NinePatchDrawable 对 象 
StateListDrawable 对 象 
ShapeDrawable 对 象 
AnimationDrawable 对 象 
Drawable 的 其 他 各 种 子 类 的 对 象 











/ res/ drawable/ 





第 5 章 ”使 用 资源 文件 fs) 


ZR 


H * 存放 的 资源 
/res/layout/ ”| 存放 各 种 用 户 界面 的 布局 文件 
/res/menu/ 存放 为 应 用 程序 定义 各 种 菜单 的 资源 ,包括 选项 菜单 、 子 菜单 、 上 下 文 菜单 资源 
该 目录 下 存放 任意 类 型 的 原生 资源 。 在 Java 代码 中 通过 调用 Resource 对 象 的 
openRawResource(int id) 方 法 获取 该 资源 的 二 进 制 输入 流 。 
实际 上 ,如 果 应 用 程序 使 用 原生 资源 ,推荐 把 这 些 原 生 资 源 保存 到 /assrts 目录 下 ,然后 在 
应 用 程序 中 使 用 AssetManager 来 访问 这 些 资源 。 
存放 各 种 简单 的 XML 文件 。 这 些 简 单 值 包括 字符 串 值 、 整 数值 .颜色 值 .数组 等 。 
字符 串 、 整 数值 .颜色 值 数组 等 各 种 值 都 是 存放 在 该 目录 下 ,而 且 这 些 资 源 文件 的 根 目 
录 都 是 < resources.../> 元 素 , 若 为 该 < resource.../> 元 素 添加 不 同 的 子 元 素 , 则 代表 不 同 
的 资源 ,例如 : 
string/integer/ bool 子 元 素 一 一 代表 添加 一 个 字符 串 值 /整数 值 /boolean 值 
color 子 元 素 一 一 代表 添加 一 个 颜色 值 
array 子 元 素 或 string-array ,int-array 子 元 素 一 一 代表 添加 一 个 数组 
style 子 元 素 一 一 代表 添加 一 个 样式 
/res/values/ — |dimen 代表 添加 一 个 尺寸 
由 于 各 种 简单 值 都 可 以 定义 在 /res/values/ 目 录 下 的 资源 文件 中 ,如 果 在 同一 份 资源 文件 
中 定义 各 种 值 ,势必 增加 程序 维护 的 难度 。 为 此 ,Android 建议 使 用 不 同 的 文件 来 存放 不 
同类 型 的 值 : 
arrays. xml 一 一 定义 数组 资源 
colors. xml 一 一 定义 颜色 值 资 源 
dimens. xml 一 一 定义 尺寸 值 资 源 
strings. xml 一 一 定义 字符 串 资源 
styles. xml 一 一 定义 样式 资源 
任意 的 原生 XML 文件 。 这 些 XML 文件 可 在 Java 代码 中 使 用 Resources. getXML() 
访问 











/res/raw/ 











/res/ xml/ 





将 应 用 程序 中 的 各 种 资源 分 别 保存 在 Android 项 目 文件 夹 下 的 res 目录 下 后 ,就 可 以 
在 Java 代码 中 使 用 这 些 资源 ,也 可 以 在 XML 文件 中 使 用 这 些 资 源 。 


6.2 通过 字体 设置 功能 使 用 字符 串 .颜色 .尺寸 资源 


本 节 所 使 用 的 实例 需要 用 到 的 字符 串 资源 .颜色 资源 .尺寸 资源 所 对 应 的 XML 文件 都 
将 被 保存 在 /res/values 目录 下 ,它们 默认 的 文件 名 以 及 在 R 类 中 对 应 的 内 部 类 如 表 5. 2 
所 示 。 
表 5.2 资源 文件 及 其 在 R 类 中 对 应 的 内 部 类 





资源 类 型 资源 文件 默认 文件 名 对 应 R 类 中 的 内 部 类 名 称 
字符 串 资源 /res/ values/strings. xml R. string 
颜色 资源 /res/ values/colors. xml R. color 


尺寸 资源 /res/values/dimens. xml R. dimen 
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本 节 通 过 一 个 具有 字体 设置 功能 的 实例 来 向 读者 介绍 如 何 使 用 字符 串 、 颜 色 . 尺寸 资 
源 。 首 先 , 字 符 串 资源 文件 strings. xml 内 容 如 下 : 


<?xml version = "1.0" encoding = "utf - 8"?» 
< resources > 
< string name = "app_name"> ResourceDemo </string> 
< string name = "text"> 我 是 文字 </string> 
< string name = "text_change"> 我 是 改变 后 的 文字 </string> 
< string name = "btn_change_text"> 改 变 文本 显示 文字 的 内 容 </string> 
< string name = "btn_change_color"> 改 变 文本 显示 文字 的 颜色 </string> 
< string name = "btn_change_size"> 改 变 文本 显示 文字 的 大 小 </string> 
</resources > 


从 上 面 的 字符 串 资 源 文 件 的 XML 代码 可 以 看 出 ,字符 串 资源 文件 的 根 元 素 是 
< resources >, 该 元 素 中 每 个 < string > 子 元 素 定 义 一 个 字符 串 常 量 , 其 中 < string > 标签 的 
name 属性 指定 该 常量 的 名 称 ,< string > 元 素 的 开始 标签 和 结束 标签 之 间 的 内 容 定义 了 字 
符 串 值 。 如 上 面 代码 中 的 < string name 一 "app_name"> ResourceDemo </string > 语句 。 
接着 ,我 们 一 起 来 看 看 颜色 资源 文件 colors. xml 中 的 内 容 , 如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 

< resources > 
< color name = "black"» & 000000 </color ><! -- 黑色 --> 
< color name = "red"> # FF0000 </color> <! -- 红色 --> 
<color name = "white"># FFFFFF </color> <! -- 白 色 --> 
<color name = "yellow"» # FFFF00 </color > <! -- Ñf --> 

</resources > 


从 上 面 的 颜色 资源 文件 的 XML 代码 可 以 看 出 ,颜色 资源 文件 的 根 元 素 是 < resources >, 该 
元 素 中 的 每 个 < color > 子 元 素 定义 了 一 个 颜色 值 常量 ,其 中 < color > 标签 的 name 属性 指定 
该 颜色 的 名 称 ,< color > 元 素 的 开始 标签 与 结束 标签 之 间 的 内 容 定义 了 颜色 值 。 如 上 面 代 
码 中 的 < color name=" red"> # FF0000 </color > 语句 。 

下 面 再 来 看 看 尺寸 资源 文件 dimens. xml 中 的 内 容 , 如 下 : 


<?xml version = "1.0" encoding = "utf — 8"?» 
< resources » 
< dimen name = "text size 16"» 16. 0sp «/dimen» 
< dimen name = "text size 20"» 16.0sp </dimen> 
«/resources > 
从 上 面 的 尺寸 资源 文件 的 XML 代码 可 以 看 出 ,尺寸 资源 文件 的 根 元 素 是 < resources >, 
该 元 素 中 的 每 个 < dimen > 子 元 素 定义 了 一 个 颜色 值 常量 ,其 中 < dimen > 标签 的 name 属性 
指定 该 颜色 的 名 称 ,< dimen > 元 素 的 开始 标签 与 结束 标签 之 间 的 内 容 定 义 了 颜色 值 。 如 上 
面 代码 中 的 < dimen name=" text_size_16"> 16. Osp </dimen > 语句 。 
至 此 ,我 们 已 将 实例 中 会 使 用 到 三 种 资源 定义 好 了 ,包括 字符 串 资 源 .颜色 资源 .尺寸 资 
源 。 现 在 开始 编写 实例 的 布局 的 XML 代码 ,如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
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android:layout width- "match parent" 
android:layout height = "match parent" 
android:gravity = "center" 
android:orientation = "vertical" > 


« TextView 
android:id- "(2 + id/txt show" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:paddingBottom = "5dp" 
android:text = "(Qstring/text" 
android:textColor = "(ücolor/white" 
android:textSize = "(Qdimen/text size 16" /> 


« Button 
android:id- "(à + id/btn change text" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: text = "(Qstring/btn change text" /> 


« Button 
android: id = "(à + id/btn change color" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "()string/btn change color" /> 


< Button 
android:id- "(à + id/btn change size" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "(Qstring/btn change size" /> 


«/LinearLayout > 
代码 文件 : codesV05 V5. 2VResourceDemoVresMayoutVactivity main. xml 


以 上 布局 文件 比较 简单 .从 上 至 下 放置 了 一 个 TextView, 用 于 显示 文字 ,三 个 Button 


按钮 分 别 代表 不 用 的 功能 , 按 下 第 一 个 Button 按钮 将 会 改变 TextView 所 显示 的 文字 , 按 
下 第 二 个 Button 按钮 将 会 改变 TextView 显示 文字 的 颜色 , 按 下 第 三 个 Button 按钮 将 会 使 
TextView 所 显示 的 文字 字体 变 大 。 


从 以 上 布局 文件 中 可 以 看 出 ,在 XML 文件 中 使 用 布局 文件 遵循 的 语法 格式 为 : 


@< resource type >/< resource name >, 例 如 ,使 用 字符 串 资源 时 用 到 @string/text, 说 明 如 下 : 


æ< resource type > 一 一 R 类 中 代表 不 同 资源 类 型 的 内 部 类 ; 

fX resource. name > 一 一 指定 资源 的 名 称 ,在 这 里 是 XML 资源 元 素 中 由 android: 
name 属性 所 指定 的 名 称 ,其实 该 资源 名 称 也 可 以 是 无 后 级 的 文件 名 , 如 放 在 
drawable-hdpi、drawable-ldpi、drawable-mdpi 这 三 个 文件 夹 下 的 图 片 资源 。 

其 实 上 面 的 语法 格式 并 不 是 完整 的 语法 格式 ,完整 的 语法 格式 为 : @[< package name >:] 


X resource type >/< resource name >,package_name 指定 了 资源 类 所 在 应 用 的 包 。 如 果 所 
引用 的 资源 和 当前 资源 位 于 同一 个 包 下 , 则 < package name > 可 以 省 略 。 


在 学 习 了 如 何在 XML 文件 里 使 用 资源 文件 后 , 接 下 来 介绍 如 何在 Java 代码 中 使 用 字 
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符 串 资源 .颜色 资源 .尺寸 资源 。 本 实例 的 MainActivity 的 Java 代码 如 下 : 
package cn. edu. hstc. resourcedemo. activity; 


import android. app. Activity; 

import android. os. Bundle; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. TextView; 


public class MainActivity extends Activity { 
private TextView show; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity main); 
show = (TextView) findViewById(R. id. txt show); 
initButton(); 

} 


private void initButton() ( 
findViewById(R. id.btn change text).setOnClickListener(new OnClickListener() { 
(QOverride 
public void onClick(View v) ( 
// 改 变 文本 显示 内 容 , 将 字符 串 资源 文件 对 应 的 字符 串 赋予 文本 显示 控件 
show. setText(R. string.text change); 
) 
ni 


findViewById(R. id.btn change color).setOnClickListener(new OnClickListener() ( 
(2 Override 
public void onClick(View v) ( 
// 使 用 颜色 资源 ,改变 文本 字体 颜色 
Show. setTextColor(getResources() .getColor(R. color. red)); 


} 
H; 


findViewById(R. id.btn change size).setOnClickListener(new OnClickListener() ( 
(2 Override 
public void onClick(View v) ( 
// 使 用 尺寸 资源 ,改变 文本 字体 大 小 
show. setTextSize(getResources().getDimensionPixel0ffset(R. dimen. text. size 20)); 
) 
Di 


代码 文件 : codes\05\5.2\ResourceDemo\cn\edu\hstc\activity\MainActivity. java 


从 上 面 的 Java 代码 可 以 看 出 ,在 Java 代码 中 按 如 下 语法 格式 使 用 资源 : [< package_ 
name >]. R. < resource type». < resource name >, SE XML 中 使 用 资源 的 语法 格式 类 似 ， 
如 果 所 使 用 的 资源 和 当前 资源 位 于 同一 个 包 下 . 则 < package name > 可 以 省 略 。 

将 上 面 的 程序 部 署 在 Android 模拟 器 上 ,运行 效果 如 图 5. 1 所 示 。 

单 击 第 一 个 按钮 ,可 以 看 到 如 图 5. 2 的 运行 效果 。 


改变 文本 显示 文字 的 内 容 


改变 文本 显示 文字 的 颜色 


改变 文本 显示 文字 的 大 小 





图 5.1 在 XML 布局 文件 中 使 用 各 种 资源 


单 击 第 二 个 按钮 ,可 以 看 到 如 图 5. 3 f 
单 击 第 三 个 按钮 ,可 以 看 到 如 图 5. 4 的 运 
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改变 文本 显示 文字 的 内 容 


改变 文本 显示 文字 的 颜色 


改变 文本 显示 文字 的 大 小 


图 5.3 在 Java 代码 中 使 用 颜色 资源 改变 文字 颜色 
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我 是 改变 后 的 文字 


5.2 E Java 代码 中 使 用 字符 串 资源 改变 文字 内 容 


行 效果 





图 5.4 在 Java 代码 中 使 用 尺寸 资源 改变 文字 大 小 
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6.3 使 用 图 片 资源 


图 片 资源 是 最 简单 的 一 种 Drawable 资源 ,只 需要 把 * . png, * . jpg, * .gif 等 格式 的 图 
片 放 入 /res/drawable-xxx 目录 下 ,Android SDK 就 会 在 编译 应 用 时 自动 加 载 该 图 片 ,并 在 
R 资源 清单 类 中 生成 该 资源 的 索引 。 

这 里 需要 注意 的 是 ,Android 不 允许 图 片 资源 的 文件 名 中 出 现 大 写字 母 , 且 不 能 以 数字 
开头 ,否则 Android SOK 无 法 为 该 图 片 在 R 类 中 生成 资源 索引 。 

使 用 图 片 资源 也 非常 简单 ,在 Java 代码 中 可 以 使 用 [< package >. ]R. drawable. < file_ 
name > 的 语法 格式 来 访问 该 图 片 资源 ,而 在 XML 代码 中 可 以 使 用 @[< package name >:] 
drawable/file_name 的 语法 格式 来 访问 图 片 资源 。 

为 了 在 程序 中 获得 实际 的 Drawable 对 象 ,Resources 提供 了 Drawable getDrawable 
Cnt id) 方 法 ,该 方法 可 根据 Drawable 资源 在 R 清单 类 中 的 ID 来 获取 实际 的 Drawable 对 象 。 

本 节 通 过 一 个 实例 来 演示 如 何在 XML 代码 中 使 用 图 片 资源 以 及 在 Java 代码 中 使 用 图 
片 资源 。 实 例 的 布局 文件 比较 简单 ,只 是 在 界面 底部 放置 一 个 Button 按钮 ,然后 在 该 按钮 
的 上 方 放置 一 个 图 片 显示 控件 ,该 Button 按钮 的 功能 是 将 图 片 容器 里 的 图 片 替 换 成 男 一 张 
图 片 。 界 面 布 局 代码 如 下 : 

<?xml version = "1.0" encoding = "utf — 8"?> 

< RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android:layout width = "match parent" 
android:layout height = "match parent" » 


< Button 
android:id- "(9 + id/button" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android: text = " 换 一 张 图 片 
android:layout alignParentBottom = "true" /> 


« ImageView 
android:id- "(9 + id/image" 
android:layout width- "fill parent" 
android:layout height - "fill parent" 
android:layout above = "(à)id/button" 
android:background - "(à drawable/a" 
android:scaleType - "fitXY" /» 


«/RelativeLayout > 
代码 文件 : codes\05\5.3\ImageResourceDemo\res\layout\activity_main. xml 


上 面 的 程序 演示 了 在 XML 代码 中 如 何 使 用 图 片 资源 。 
接 下 来 看 看 在 Java 代码 中 如 何 使 用 图 片 资源 ,代码 如 下 : 


package cn. edu. hstc. imageresourcedemo. activity; 


import com. example. imageresourcedemo.R; 
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import android. app. Activity; 
import android. os. Bundle; 

import android. view. View; 

import android. widget. ImageView; 


public class MainActivity extends Activity ( 
ImageView image = null; 
(QOverride 
protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
setContentView(R. layout.activity main); 
image = (ImageView) findViewById(R. id. image); 
findViewById(R. id. button). setOnClickListener(new View.OnClickListener() ( 
@Override 
public void onClick(View v) { 
// 在 Java 代码 中 使 用 图 片 资源 
image. setImageDrawable( getResources(). getDrawable(R. drawable. b)); 


n; 
) 


代码 文件 : codes\05\5. 3\ImageResourceDemo\cn\edu\hstc\activity\MainActivity. java 


上 面 的 程序 演示 了 如 何在 Java 代码 中 使 用 图 片 资源 。 

将 程序 部 署 在 模拟 器 上 ,运行 效果 如 图 5.5 所 示 。 

单 击 布局 最 下 面 的 “ 换 一 张 图 片 ”按钮 ,会 看 到 界面 上 的 图 片 被 替换 成 男 外 一 张 ,运行 效 
果 如 图 5.6 所 示 。 
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图 5.5 在 XML 界面 布局 中 直接 使 用 图 片 资源 图 5.6 在 Java 代码 中 使 用 图 片 资源 


Q Android 应 用 开发 从 入 门 到 精通 


6.4 通过 声音 播放 功能 使 用 样式 资源 ,主题 资源 和 原始 资源 


假如 经 常 需要 对 某 个 类 型 的 组 件 设置 大 致 相似 的 属性 和 对 应 的 属性 值 ,也 就 是 说 ,该 类 
型 的 组 件 在 该 应 用 中 保持 一 样 的 长 相 , 例 如 字体 、 颜 色 、 背 景色 等 。 如 果 每 次 都 对 该 View 
组 件 进行 重复 的 属性 的 指定 ,这 明显 是 不 科学 的 ,也 不 利于 后 期 项 目的 维护 。 

类 似 于 Web 开发 中 定义 一 个 一 个 的 css 文件 ,文件 中 的 一 块 一 块 的 css 代码 , Android 
提供 了 样式 资源 的 概念 : 一 个 样式 等 于 一 组 格式 的 集合 。 为 一 个 组 件 设置 了 某 个 样式 后 ， 
该 样式 所 包含 的 全 部 格式 将 会 应 用 于 该 组 件 。 这 就 是 样式 资源 。 

主题 资源 与 样式 资源 非常 类 似 , 主 要 区 别 在 于 : 

。 主题 资源 不 能 作用 于 单个 View 组 件 , 主 题 应 用 对 整个 应 用 中 的 所 有 的 Activity 起 

作用 或 对 指定 的 Activity 起 作用 。 

。 主题 资源 定义 的 格式 应 该 是 改变 窗口 外 观 的 格式 ,例如 ,窗口 标题 .窗口 边框 等 。 

原始 资源 , 指 的 是 声音 资源 等 Android 应 用 会 用 到 的 大 量 的 原生 态 的 资源 。 类 似 声音 
文件 以 及 其 他 各 种 类 型 的 文件 ,只 要 Android 没有 为 其 提供 专门 的 支持 ,这 种 资源 都 被 称 为 
原始 资源 。Android 的 原始 资源 被 存放 在 /res/raw 目录 下 以 及 /assets 目录 下 。 只 是 
Android SDK 会 在 R 清单 类 中 为 /res/raw 目录 下 的 资源 生成 一 个 索引 ,而 /assets 目录 下 
的 资源 会 是 更 彻底 的 原始 资源 ,Android 应 用 需要 通过 Asset Manager 来 管理 该 目录 下 的 原 

本 节 通 过 一 个 简单 的 声音 播放 功能 来 介绍 如 何 使 用 样式 资源 .主题 资源 始 资源 。 
实例 需要 用 到 的 样式 资源 以 及 主题 资源 文件 my. style. xml 代码 如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 
< resources xnlns:android = "http://schemas.android. com/apk/res/android"» 
<! -- 定义 一 个 样式 ,指定 字号 大 小 以 及 字体 颜色 --> 
< style name = " stylel"> 
< item name = "android:textSize"» 20sp </item> 
< item name = "android: textColor">#FF0000 </item> 
</style> 


<! -- 定义 一 个 样式 ,继承 前 一 个 样式 --> 
< style nane = "style2" parent = "@ style/stylel"> 
< item name = "android:background"># FFFF00 </item> 
< item name = "android:padding"> 8dp </item> 
<! -- 覆盖 父 样式 中 指定 的 属性 --> 
< item name = "android:textColor"» # 000000 </item> 
</style> 


<! -- 定义 主题 资源 -一 > 
< style name = "mytheme"> 

< item name = "android:windowNoTitle"> true </item> 

< item name = "android:windowFullscreen"» true </item> 
android:windowBackground"»(2drawable/ic launcher </item> 


< item name = 
</style> 
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代码 文件 : codes\05\5. 4\AudioDemo\res\values\my_style. xml 


从 上 面 的 代码 可 以 看 出 ,样式 以 及 主题 资源 文件 的 根 元 素 是 < resources >, 该 元 素 内 可 
包含 多 个 < style > 子 元 素 ,每 个 < style > 元 素 定义 一 个 样式 或 主题 ,< style > 元 素 指定 如 下 两 
个 属性 : 

。 name 一 一 指定 样式 或 主题 的 名 称 ; 

* parent 一 一 指定 该 样式 或 主题 所 继承 的 父 样式 或 父 主题 。 当 继承 某 个 父 样式 或 主 
题 ,该 样式 或 主题 将 会 获得 父 样式 或 主题 中 定义 的 全 部 资源 ,当然 ,当前 样式 或 主题 
也 可 以 对 父 样式 或 主题 的 属性 进行 重新 设置 。 

例如 ,在 上 面 的 代码 中 ,定义 了 两 个 样式 ,第 二 个 样式 继承 了 第 一 个 样式 并 对 第 一 个 样 
式 的 android :textColor 属性 进行 重新 设 定 。 

接 下 来 ,看 一 下 在 布局 XML 文件 中 如 何 使 用 上 面 所 定义 的 样式 和 主题 ,实例 的 布局 文 
件 代码 如 下 : 

<?xml version = "1.0" encoding = "utf 一 8"?> 

< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 

android: layout_width= "match parent" 
android:layout height = "match parent" 


android:orientation = "vertical" 
android:padding = "5dp" > 


«/resources > 





< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


« TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "ji 1: " /> 


« EditText 
android:layout width = "200dp" 
android:layout height = "wrap content" 
android:text = "testl.mp3" 
style = "(Jstyle/stylel" /> 


« Button 
android:id- "@ + id/buttonl" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "播放 " /> 
</LinearLayout > 


<LinearLayout 
android:layout width= "fill parent" 
android:layout height = "wrap content" 
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android:orientation = "horizontal" > 


< TextView 
android: layout width= "wrap content" 
android: layout height = "wrap_content" 
android:text = " 声 源 1: " /> 


« EditText 
android:layout width = "200dp" 
android:layout height = "wrap content" 
android:text = "test2.mp3" 
style = "(Qstyle/style2" /> 


< Button 
android:id- "(à + id/button2" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "播放 " /> 
</LinearLayout > 


</LinearLayout > 
代码 文件 : codes\05\5.4\AudioDemo\res\layout\activity_main. xml 


从 上 面 的 代码 可 以 看 出 ,在 XML 中 使 用 样式 资源 的 语法 格式 为 @[< package name 7: ] 
style/file_name。 接 着 再 看 看 如 何 使 用 主题 资源 ,一 般 使 用 主题 资源 是 通过 Android 全 局 
配置 文件 AndroidManifest. xml 来 指定 Activity 或 整个 应 用 所 使 用 到 的 主题 。 代 码 如 下 : 


< manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
package = "con. example. audiodemo" 
android:versionCode = "1" 
android:versionName = "1.0" > 


< uses - sdk 
android:minSdkVersion - "8" 
android:targetSdkVersion = "8" /> 


<! -- 在 全 局 配置 文件 中 使 用 主题 资源 --> 
< application 
android:allowBackup = "true" 
android: icon = "(Qdrawable/ic launcher" 
android: label = "@string/app_name" 
android: theme = "@style/mytheme" > 
<activity 
android:name = "cn. edu. hstc. audiodemo. activity. MainActivity" 
android: label = "@string/app_name" > 
< intent ~ filter > 
< action android:name = "android. intent. action. MAIN" /> 





< category android:name = "android. intent. category. LAUNCHER" /> 
«/intent- filter» 
«/activity» 
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</application> 


</manifest > 
代码 文件 : codes\05\5. 4\AudioDemo\ AndroidManifest. xml 


上 面 的 代码 在 < application > 标签 指定 了 android: theme 的 属性 值 为 my_style. xml 中 
对 应 的 主题 资源 , 即 可 让 该 主题 资源 作用 于 整个 应 用 的 Activity, 下 面 的 每 个 < Activity > 标 
签 也 可 以 单独 指定 该 属性 ,覆盖 < application > 标签 中 指定 的 主题 资源 。 从 代码 可 以 看 出 ， 
在 XML 文件 中 使 用 主题 资源 的 语法 格式 与 使 用 样式 资源 一 样 。 

接 下 来 ,看 一 下 布局 文件 所 对 应 的 Activity Java 代码 ,在 该 Activity 文件 中 ,将 对 一 开 
始 放 在 /res/raw 目录 下 的 testl. mp3 文件 以 及 /assets 目录 下 的 test2. mp3 文件 这 两 个 原 
生 资 源 进 行 访问 。 主 程序 代码 如 下 : 


package cn. edu. hstc. audiodemo. activity; 


import com. example. audiodemo. R; 


import android. app. Activity; 

import android. content. res. AssetFileDescriptor; 
import android. content. res. AssetManager; 

import android. media. MediaPlayer; 

import android. os. Bundle; 

import android. view. View; 


public class MainActivity extends Activity ( 

MediaPlayer mediaPlayerl - null; 

MediaPlayer mediaPlayer2 - null; 

(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R. layout.activity main); 
// 直 接 根据 声音 文件 的 ID 来 创建 MediaPlayer 
mediaPlayerl = MediaPlayer.create(this, R.raw.testl); 


// 获 取 应 用 的 AssetManager 
AssetManager am = getAssets(); 
try { 


// 获 取 指 定 文件 对 应 的 AssetFileDescriptor 
AssetFileDescriptor afd = am. openFd("test2.mp3"); 
mediaPlayer2 = new MediaPlayer(); 
// 使 用 MediaPlayer 加 载 指 定 的 声音 文件 
mediaPlayer2.setDataSource(afd.getFileDescriptor()); 
mediaPlayer2.prepare(); 

) catch (Exception e) ( 
e. printStackTrace(); 

} 


// 获 取 第 一 个 按钮 并 为 其 绑 定 事件 监听 器 
findViewById(R. id. buttonl).setOnClickListener(new View.OnClickListener() { 


@Override 
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public void onClick(View v) { 
// 播 放声 音 
mediaPlayerl.start(); 
) 
n; 
// 获 取 第 二 个 按钮 并 为 其 绑 定 事件 监 听 器 
findViewById(R. id. button2).setOnClickListener(new View.OnClickListener() ( 
(QOverride 
public void onClick(View v) ( 
// 播 放声 音 
mediaPlayer2.start(); 


代码 文件 : codes\05\5.4\AudioDemo\cn\edu\hstc\activity\MainActivity. java 


上 面 的 代码 分 别 获 取 /res/raw 和 /assets 目录 下 的 资源 作为 两 个 MediaPlayer 的 声 源 
文件 ,并 赋予 两 个 Button 控件 不 同 的 事件 监听 器 来 播放 声音 。 从 上 面 的 Java 代码 可 以 看 
出 ,使 用 /res/raw 目录 下 的 原始 资源 的 语法 格式 为 [< package >. JR. raw. € file name >, 当 
然 ,由 以 往 的 经 验 可 以 知道 ,在 XML 代码 中 访问 /res/raw 目录 下 的 原始 资源 的 语法 格式 
为 : @[< package name >; ]raw/file name, 

而 获取 /assets 目录 下 的 原始 资源 则 需要 通过 一 个 专门 管理 /assets 目录 下 的 原始 资源 
的 管理 器 类 AssetManager, 本 示例 通过 该 类 的 AssetFileDescriptor openFd (String 
fileName) 方 法 ,根据 文件 名 来 获取 原始 资源 对 应 
的 AssetFileDescriptor, 再 通过 AssetFileDescriptor 
的 getFileDescriptor () 方 法 来 获取 对 应 的 原始 
资源 。 

事实 上 ,还 有 另外 的 一 种 获取 /assets 目录 下 
的 资源 的 方法 ,就 是 通过 InputStream open 
(String fileName) 方 法 ,根据 文件 名 来 获取 原始 资 
源 对 应 的 输入 流 。 

至 此 ,对 如 何 使 用 样式 资源 .主题 资源 以 及 原 
始 资源 已 经 全 部 介绍 完毕 , 接 下 来 ,把 应 用 部 署 在 
Android 模拟 器 上 ,将 会 看 到 如 图 5. 7 所 示 的 运行 
效果 。 

分 别 单 击 界面 上 的 两 个 Button 按钮 ,可 以 听 
到 不 同 的 音乐 。 从 运行 效果 也 可 以 看 出 ,两 个 文 
本 框 控件 的 样式 受到 了 my style. xml 文件 中 定 
义 的 样式 资源 sytlel 以 及 style2 的 影响 ,分 别 呈 
现 出 不 同 的 效果 ,而 整个 窗 体 则 受到 了 my_style. 
xml 文件 中 的 定义 的 主题 资源 的 影响 ,呈现 了 没有 
状态 栏 ,全屏 .背景 为 Android Robot 的 效果 。 图 5.7 使 用 样式 .主题 ,原始 资源 





6.5 本 章 小 结 


本 章 主要 介绍 了 Android 应 用 资源 的 使 用 ,通过 使 用 各 种 资源 文件 ,Android 应 用 可 以 
把 各 种 字符 串 、 图 片 、 颜 色 、 界 面 布局 等 交 给 XML 文件 配置 管理 ,形成 了 一 种 高 度 解 耦 的 设 
计 模 式 。 各 种 Android 资源 的 存储 方式 以 及 如 何 使 用 是 本 章 的 学 习 重 点 。 当 然 , 除 了 本 章 


所 介绍 的 几 种 资源 以 外 ,还 有 很 多 其 他 类 型 的 资源 ,在 日 后 的 学 习 工 作 中 ,读者 可 以 慢 慢 进 
行 了 解 。 





通过 商品 发 布 器 详细 介绍 Activity 


本 章 将 通过 自身 设计 的 一 个 小 应 用 一 一 商品 发 布 器 来 向 读者 详细 介绍 Android 的 一 个 
重要 的 组 件 Activity。6. 1 节 在 代码 的 角度 介绍 商品 发 布 器 的 实现 ,6. 2 节 通 过 齐 析 该 商品 
发 布 器 介绍 Activity 的 建立 .配置 .启动 和 关闭 ,并 从 中 理解 Activity 的 回调 机 制 和 生命 
周期 。 


6.1 实现 商品 发 布 器 


本 节 的 主要 内 容 是 介绍 如 何 实现 商品 发 布 器 。 首 先 ,看 一 下 该 应 用 的 启动 界面 的 布局 
代码 ,也 就 是 activity. main. xml 文件 的 内 容 , 如 下 : 





<?xml version= "1.0" encoding = "utf - 8"?> 
< TableLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:padding = "10dp" 
android:stretchColumns = "1" > 


« TableRow 
android:layout width = "fill parent" 
android:layout height = "wrap content" > 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "商品 名 称 : " /> 


< EditText 
android:id= "(9 + id/edt name" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:hint = "请 输入 商品 名 称 ”/> 
</TableRow> 


< TableRow 
android:layout width- "fill parent" 
android:layout height = "wrap content" > 
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< TextView 
android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:text = "商品 种 类 : " /> 


< Spinner 
android:id- "(à + id/sp type" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:pronmpt = "(8)string/hint" 
android:entries = "(Qarray/type" /> 
«/TableRow > 


< TableRow 
android:layout width- "fill parent" 
android:layout height = "wrap content" > 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "商品 价格 : " /> 


< EditText 
android:id- "@ + id/edt price" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android: hint = "请 输入 商品 价格 (RMB)”/> 
</TableRow> 


< TableRow 
android:layout_width = "fill parent" 
android:layout height = "wrap content" > 


« Button 
android:id- "(9 + id/btn release" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "Afi" /> 


« Button 
android:id- "(à + id/btn show" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "查看 已 有 商品 " /> 
</TableRow> 


</TableLayout > 


代码 实现 在 界面 上 从 上 而 下 分 为 四 行 ,第 一 行 第 一 列 和 第 二 列 分 别 显示 “商品 名 称 : ” 
这 四 个 字 以 及 一 个 供用 户 输入 商品 名 称 的 文本 输入 框 ,第 二 行 第 一 列 和 第 二 列 分 别 显 示 “ 商 
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品种 类 : ”这 四 个 字 以 及 一 个 供用 户 选择 商品 种 类 的 下 拉 列 表 控 件 , 第 三 行 第 一 列 和 第 二 列 
分 别 显示 “商品 价格 : ”这 四 个 字 以 及 一 个 供用 户 输入 商品 价格 的 文本 输入 框 ,第 四 行 第 一 
列 和 第 二 列 分 别 显示 “发 布 ”按钮 和 “查看 已 有 商品 ”按钮 。 

布局 最 外 层 采用 表格 布局 TableLayout 方式 ,这 种 布局 方式 已 经 在 前 面 的 章节 有 所 介 
绍 ,此 处 不 再 袭 述 。 代 码 中 使 用 到 了 一 个 下 拉 控 件 Spinner, 该 Spinner 的 填充 数据 源 来 自 
一 个 数组 type, 如 代码 中 android:entries 二 "@array/type" 这 一 行 所 示 , 于 是 应 用 需要 访问 
一 个 数组 资源 文件 ,该 资源 文件 位 于 /res/values/ 下 ,文件 内 容 如 下 : 


«?xnl version= "1.0" encoding = "utf - 8"?> 
<resources> 
< string- array name = "type"> 
< item > 食品 </item> 
< item> 生 活用 品 </item> 
< item> 电 脑 配件 </item> 
< item > 电子 元 件 </item> 
«/string- array» 
«/resources > 


在 这 里 ,我 们 需要 讲 一 下 需求 ,应 用 在 启动 界面 中 编辑 要 发 布 的 商品 信息 ,然后 单 击 “ 发 
布 ”按钮 ,将 该 商品 上 传 至 服务 器 端 ,服务 器 端 获取 该 商品 信息 并 保存 在 服务 端 数据 库 表 中 。 
用 户 单 击 界面 中 的 “查看 已 有 商品 ”按钮 将 会 跳 转 到 另 一 个 页 面 ,在 该 页 面 中 去 访问 服务 端 
并 Get 到 数据 库 表 中 保存 的 所 有 商品 ,然后 显示 在 该 页 面 上 的 ListView 控件 。 因 此 需要 
在 /res/layout/ 目 录 下 新 建 一 个 新 的 界面 布局 文件 activity show. xml, 该 文件 内 容 如 下 : 


<?xml version= "1.0" encoding = "utf - 8"?> 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height - "match parent" 
android:background = "(2 drawable/segmented bg" 
android:orientation = "vertical" > 


< RelativeLayout 
android:layout width = "fill parent" 
android:layout height = "40dp" 
android:background = "(2 drawable/topback" > 


< InmageView 
android:id- "@ + id/img back" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:paddingLeft = "5dp" 
android:layout alignParentLeft - "true" 
android:layout centerVertical = "true" 
android: src = "(Qdrawable/backbtn" /> 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
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android:layout centerInParent = "true" 

android:text = "查看 已 有 商品 " 

android:textColor = "(Qcolor/white" 

android:textSize = "22sp" /> 
«/RelativeLayout > 


< ListView 
android: id= "(9 + id/listView" 
android:layout_width = "fill_parent" 
android:layout height = "wrap content" 
android:divider = "@color/black" 
android:background = "@drawable/segmented_bg" 
android:dividerHeight = "1px" /> 


</LinearLayout > 


在 该 程序 中 ,需要 用 到 一 个 实体 类 ,用 来 代表 商品 ,在 src 目录 下 新 建 包 cn. edu. hste. 
commodityrelease. entity 并 新 建 类 Commodity ,该 类 内 容 如 下 : 


package cn. edu. hstc. commodityrelease. entity; 


Public class Commodity { 
public Integer theld; 
public String name; 
public String type; 
public String price; 


public Integer getTheId() ( 


return theld; 


public void setTheId(Integer theId) ( 
this. theld = theId; 


public String getName() { 
return name; 


public void setName(String name) { 
this.name - name; 


public String getType() ( 
return type; 


public void setType(String type) { 
this.type - type; 
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public String getPrice() { 
return price; 


public void setPrice(String price) { 
this.price = price; 


public Commodity(Integer theId, String name, String type, String price) { 
this.theId = thelId; 
this.name = name; 

type; 

this.price = price; 


this.type 


} 


由 于 第 二 个 界面 用 到 了 ListView 这 个 控件 ,该 控件 需要 设置 适配器 ,这 里 为 该 显示 商 
品 的 ListView 定制 了 一 个 适配器 ,新 建 cn. edu. hstc. commodityrelease. util 包 并 新 建 
MyListViewAdapter 类 ,该 类 程序 代码 如 下 : 


package cn. edu. hstc. commodityrelease. util; 


import java. util. ArrayList; 
import java. util. List; 


import android. content. Context; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget. BaseAdapter; 

import android. widget. TextView; 

import cn. edu. hstc. commodityrelease. entity. Commodity; 


import com. example. commodityrelease.R; 


public class MyListViewAdapter extends BaseAdapter { 
// 定 义 一 个 存放 商品 信息 的 List 集合 
private List < Commodity» commodityList = new ArrayList < Commodity>(); 
// 声 明 LayoutInflater 类 ,用 以 后 期 载 人 XML 界面 
private LayoutInflater inflater; 


/[** 

* 在 构造 器 中 初始 化 List 集合 以 及 初始 化 LayoutInflater 

*/ 
public MyListViewAdapter(Context context, List < Commodity> commodityList) { 

this. commodityList = commodityList; 
inflater = (LayoutInflater) context. getSystemService (Context. LAYOUT _ INFLATER _ 
SERVICE); 

) 


(QOverride 
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public int getCount() ( 
return commodityList.size(); 


(QOverride 
public Object getItem(int position) ( 
return commodityList.get(position); 


(QOverride 
public long getItemId(int position) { 
return position; 


(QOverride 
public View getView(int position, View convertView, ViewGroup parent) { 
ViewHolder holder - null; 
if (convertView == null) { 
// 载 人 ListView 的 Item 项 的 布局 文件 listview item 
convertView = inflater.inflate(R.layout.listview item, null); 
holder = new ViewHolder(); 
holder. name = (TextView) convertView. findViewById(R. id.list txt name); 
holder.type = (TextView) convertView. findViewById(R. id.list txt type); 
convertView. setTag(holder); 
) eise ( 
holder = (ViewHolder)convertView.getTag(); 
) 
holder. name. setText (commodityList.get(position).name); 
holder.type.setText("[" * commodityList.get(position).type * "]"); 
return convertView; 


public void addItem(final Commodity commodity) ( 
commodityList.add(commodity); 
notifyDataSetChanged(); 


public static class ViewHolder { 
public TextView name; 
public TextView type; 


} 


上 述 代 码 中 用 到 了 一 个 xml 文件 listview_item. xml. 该 文件 描述 了 ListView 的 每 个 
item 的 外 观 ,该 文件 内 容 如 下 : 


<?xml version = "1.0" encoding = "utf - 8"?» 

< RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width- "match parent" 
android:layout height = "match parent" 
android:descendantFocusability = "blocksDescendants" 
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android:paddingLeft = "10dp" 
android:paddingRight - "10dp" » 


« TextView 
android:id- "(9 + id/list txt type" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout centerVertical = "true" 
android:textColor = "(3color/white" 
android:textSize - "20sp" /» 


« TextView 
android:id- "@ + id/list txt name" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout centerVertical- "true" 
android:layout toRightOf = "(2id/list txt type" 
android:paddingLeft = "5dp" 
android:textColor = "(Qcolor/white" 
android:textSize- "20sp" /> 


< InageView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout alignParentRight = "true" 
android:layout centerVertical- "true" 
android:layout marginTop - "6dp" 
android:layout marginBottom = "6dp" 
android:background = "(Zdrawable/to" /> 









«/RelativeLayout > 
接 下 来 ,看 看 实现 第 一 个 Activity 的 主 程序 代码 MainActivity. java, 代 码 如 下 : 


package cn. edu. hstc. commodityrelease. activity; 


import java. util. HashMap; 
import java. util. Map; 


import org. json. JSONObject ; 


import android. app. Activity; 

import android. app. AlertDialog; 

import android. content. DialogInterface; 

import android. content. DialogInterface. OnCancelListener; 
import android. content. Intent; 

import android. os. AsyncTask; 

import android. os. Bundle; 

import android. util. Log; 

import android. view. View; 

import android. view. View. OnClickListener; 
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import android. widget. Button; 

import android. widget. EditText; 

import android. widget. Spinner; 

import android. widget. TextView; 

import android. widget. Toast; 

import cn. edu. hstc. commodityrelease.util.HttpUtil; 


import com. example. commodityrelease.R; 


public class MainActivity extends Activity implements OnClickListener ( 
// 声 明 界 面 布局 中 的 各 个 组 件 
private EditText name, price; 
private Spinner type; 
private Button release, show; 


private AlertDialog prompt; 

// 声 明 异 步 类 AsyncTask 

private AsyncTask < String, Integer, String» access; 
private Toast toast; 


(QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
// 加 载 布局 文件 
setContentView(R. layout.activity main); 
init(); 


/** 
* 获得 界面 组 件 并 为 其 设置 监听 器 ,这 里 监听 器 为 Mainhctivity 本身 
*/ 
private void init() { 
name = (EditText) findViewById(R. id. edt name); 
type = (Spinner) findViewById(R. id. sp type); 
price - (EditText) findViewById(R. id. edt price); 
release - (Button) findViewById(R. id.btn release); 
show = (Button) findViewById(R. id. btn show); 


// 为 发 布 按钮 设置 监听 器 
release. setOnClickListener(this); 
// 为 查看 已 有 商品 按钮 设置 监听 器 
show. setOnClickListener(this); 

) 

(QOverride 


public void onClick(View v) ( 
switch (v.getId()) ( 
case R. id. btn release: 
release(); 
break; 
case R. id. btn show: 
show(); 
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break; 
default: 
break; 


/ xx 
* 发 布 商 品 
*/ 
private void release() { 
Map < String, String» map = new HashMap «String, String»(); 
// 以 下 将 商品 各 个 属性 存放 在 map 中 
if (name != null) { 
map. put("name", name.getText(). toString()); 
) 
if (type != null) ( 
map. put("type", type.getSelectedItem().toString()); 
) 
if (price != null) { 
map. put("price", price.getText(). toString()); 
) 
// 触 发 该 方法 ,请 求 CommodityServlet 将 商品 属性 作为 参数 提交 到 后 台中 
acquire(map，" 正 在 提交 中 ..."，true，"CommodityServlet" ) 


[x 
* 查看 已 有 商品 
*/ 
private void show() ( 
Intent intent = new Intent(MainActivity.this, ShowActivity.class); 
// 跳 转 到 另 一 个 页 面 ShowActivity 中 
MainActivity. this. startActivity(intent); 


/ xx 
* 请 求 方法 ,启动 任务 ,请 求 后 台 路 径 
* (param map 
* @param promptStr 
* (param dialog 


* @param servletStr 
*/ 
private void acquire(final Map< String, String> map, final String promptStr, final boolean 
dialog, final String servletStr) { 
access = new AsyncTask« String, Integer, String»() ( 
(QOverride 
protected void onPreExecute() { 
super. onPreExecute( ) ; 
if (dialog) ( 
prompt - HttpUtil.prompt(MainActivity.this, promptStr); 
prompt. setOnCancelListener(new OnCancelListener() { 
(GOverride 
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public void onCancel (DialogInterface dialog) { 
access. cancel (true); 


ni 


(QOverride 
protected String doInBackground(String... params) ( 
String result = null; 
try { 
result - HttpUtil.request(HttpUtil. BASE URL * servletStr, map); 
} catch (Exception e) ( 
e. printStackTrace(); 
} 


return result; 


@Override 
protected void onPostExecute(String result) { 
Log.i("", "MainActivity result: " * result); 
prompt. dismiss(); 
try { 
if (result != null) { 
JSONObject object = new JSONObject(result); 
if (object. getString("result").equals("ffi A JJ! ")) ( 
setToast(" 发 布 成 功 !") ; 
) else if (object. getString("result").equals(" 插 入 失败 !")) ( 
setToast(" X Ti Wt"); 
) else if (object. getString("result").equals("/ci & Hi i1 ")) ( 
setToast(" 后 台 出 错 !"); 


} 
} catch (Exception e) ( 
e. printStackTrace(); 


}; 


access. execute( ); 


private void setToast(String message) { 
if (toast!- null) ( 
((TextView) toast.getView()).setText(message); 
} else { 
toast = HttpUtil.createToast(MainActivity.this, message); 
} 
toast. show() ; 
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该 类 主要 实现 用 户 单 击 “ 发 布 ”按钮 时 将 数据 提交 到 后 台数 据 库 中 以 及 单 击 “查看 已 有 
商品 ?按钮 时 跳 转 到 另 一 个 页 面 的 功能 ,类 中 调用 了 一 个 工具 类 HttpUtil, 该 工具 类 实现 具 
体 的 与 后 台 进行 数据 交互 的 操作 ,在 此 不 袭 述 ,读者 可 以 查看 本 书 附 带 的 源码 。 最 后 来 看 一 
下 当 用 户 单 击 “ 查 看 已 有 商品 ”按钮 时 跳 转 到 的 页 面 ShowActivity 的 具体 实现 ,代码 如 下 : 


package cn. edu. hstc. commodityrelease. activity; 


import java.util.ArrayList; 
import java. util. HashMap; 
import java.util.List; 
import java.util.Map; 


import org. json. JSONArray; 
import org. json. JSONObject ; 


import android. app. Activity; 

import android. app. AlertDialog; 

import android. content.DialogInterface; 

import android. content. DialogInterface. OnCancelListener; 
import android. content. Intent; 

import android. os. AsyncTask; 

import android. os. Bundle; 

import android. util.Log; 

import android. view. View; 

import android. widget. AdapterView; 

import android. widget. AdapterView. OnItemClickListener; 
import android. widget. ImageView; 

import android. widget.ListView; 

import android. widget. TextView; 

import android. widget. Toast; 

import cn. edu. hstc. comnodityrelease. entity. Commodity; 
import cn. edu. hstc. comnodityrelease. util. HttpUtil; 
import cn. edu. hstc. commodityrelease. util. MyListViewAdapter; 


import com. example. commodityrelease.R; 


public class ShowActivity extends Activity { 
// 加 载 页 面 组 件 
private ImageView backImg; 
// 定 义 一 个 List 集合 ,用 于 动态 存储 从 后 台 获取 到 的 商品 列表 
private List < Commodity» commodityList = new ArrayList < Commodity>(); 
// 声 明 布局 上 的 ListView 
private ListView listView; 
// 声 明 一 个 ListView 的 适配器 Adapter 
private MyListViewAdapter adapter; 


private AlertDialog prompt; 
private AsyncTask < String, Integer, String» access; 
private Toast toast; 
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(QOverride 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
// 加 载 界面 布局 文件 
setContentView(R.layout.activity show); 
// 获 取 返 回 按钮 
backImg = (ImageView) findViewById(R. id. img back); 
// 为 返回 按钮 添加 事件 监听 器 
backImg. setOnClickListener(new View.OnClickListener() ( 
(QOverride 
public void onClick(View v) { 
ShowActivity. this.finish(); 


np; 

Map < String, String» map = new HashMap «String, String»(); 
map. put("nane", ""); 

// 请 求 后 台 GetCommoditys, 加 载 数据 并 完成 页 面 更 新 操作 
acquire(map, "数据 加 载 中 ..."，true, "GetCommoditys"); 


/ xx 
请 求 后 台 , 加 载 数据 并 完成 页 面 更 新 操作 
@paran map 
(& param promptStr 
(E) param dialog 
(Qparam servletStr 
/ 
private void acquire(final Map «String, String» map, final String promptStr, final boolean 
dialog, final String servletStr) ( 
access = new AsyncTask < String, Integer, String>() ( 
@Override 
protected void onPreExecute() { 
super. onPreExecute( ) ; 
if (dialog) ( 
prompt - HttpUtil.prompt(ShowActivity.this, promptStr); 
prompt. setOnCancelListener(new OnCancelListener() ( 
@Override 
public void onCancel(DialogInterface dialog) { 
access. cancel(true); 


e koe ke ke oie o 


n; 


(2 Override 
protected String doInBackground(String... params) ( 
String result - null; 
try { 
result - HttpUtil.request(HttpUtil.BASE URL * servletStr, map); 
} catch (Exception e) ( 
e. printStackTrace(); 
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) 


return result; 


(QOverride 
protected void onPostExecute(String result) ( 
prompt.dismiss(); 
try { 
if (result != null) { 
JSONObject object = new JSONObject(result); 
if (object. getString("result") .equals(" 后 台 出 错 !")) ( 
setToast(" 后 台 出 错 !"); 
) eise if (object. getString("result").equals("[]")) ( 
setToast(" 暂 无 数据 !"); 
) else ( 
JSONArray array = object.optJSONArray("result"); 
for (inti-0;i«array.length();i**) { 
Commodity commodity = new Commodity(array. optJSONObject 
(i).getInt(" theId"), array. optJSONObject (i). optString(" name"), array. optJSONObject (i). 
optString("type"), array. optJSONObject(i).optString("price")); 
commodityList. add(commodity); 
Log. v("ShowActivity", commodity.getName()); 


adapter - new MyListViewAdapter (ShowActivity. this, 
commodityList); 
listView = (ListView) findViewById(R. id. listView); 
listView. setAdapter(adapter); 
listView. setOnItemClickListener(new OnlItemClickListener() ( 
@Override 
public void onItemClick (AdapterView <?> arg0, View argl, 
int arg2, long arg3) { 
Commodity commodity = commodityList. get(arg2); 
Bundle bundle = new Bundle(); 
bundle. putInt("theId", commodity.getTheId()); 
bundle. putString("name", commodity. getName()); 
bundle. putString("type", commodity.getType()); 
bundle. putString( "price", commodity.getPrice()); 
Intent intent = new Intent(ShowActivity. this, 
UpdateActivity.class); 
intent. putExtras(bundle); 
startActivity(intent); 
ShowActivity.this.finish(); 


n; 
) 


} catch (Exception e) ( 
e. printStackTrace(); 


access. execute() ; 
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} 


private void setToast(String message) { 
if (toast!- null) { 
((TextView) toast.getView()).setText(message); 
} else { 
toast = HttpUtil.createToast(ShowActivity.this, message); 
M show(); 
j } 
该 类 主要 实现 请 求 后 台数 据 并 将 加 载 到 的 数据 作为 数据 源 填充 在 页 面 中 的 ListView 
组 件 的 功能 ,类 中 所 用 到 的 与 后 台数 据 交 互 的 技术 与 MainActivity 中 用 到 的 技术 类 似 , 读 
者 可 以 慢 慢 体会 。 
单 击 ShowActivity 页 面 中 的 ListView 的 每 一 条 数据 ,将 会 跳 转 到 该 条 商品 信息 的 修 
改 页 面 ,修改 该 条 商品 信息 后 单 击 保存 修改 按钮 把 数据 提交 到 后 台 , 由 后 台 修 改 对 应 的 数据 
库 表 数据 。 该 Activity 的 布局 与 MainActivity 类 似 , 实 现 主 程序 也 与 MainActivity 类 似 ， 
此 处 不 再 次 述 ,读者 可 以 在 本 书 所 附带 的 源码 中 查看 。 
而 代码 中 所 请 求 的 后 台 实现 ,也 在 本 书 所 附带 的 源码 中 ,读者 可 直接 发 布 后 使 用 。 至 
此 ,实现 商品 发 布 器 的 主要 的 客户 端 代 码 已 介绍 完毕 。 
将 程序 部 署 在 Android 模拟 器 中 ,启动 应 用 ,可 以 看 到 如 图 6. 1 所 示 启 动 界面 。 
单 击 “ 查 看 已 有 商品 "按钮 , 跳 转 到 如 图 6. 2 所 示 界 面 。 


查看 已 有 商品 





图 6.1 商品 发 布 器 商品 编辑 界面 图 6.2 查看 已 有 商品 
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单 击 第 一 条 数据 , 跳 转 到 商品 修改 界面 ,如 图 6.3 所 示 。 


商品 价格 : 12 


EN NN 





图 6.3 商品 修改 页 面 
接 下 来 对 该 商品 发 布 器 进行 剖析 ,并 详细 介绍 Activity. 


6.2 剖析 商品 发 布 器 


Activity 作为 Android 四 大 组 件 之 一 ,是 Android 应 用 中 最 重要 以 及 最 常用 的 应 用 组 
件 (此 处 组 件 并 非 指 界面 控件 ), 所 以 Android 应 用 开发 的 一 个 重要 环节 就 是 开发 Activity. 
本 节 主 要 是 通过 剖析 6. 1 节 所 实现 的 商品 发 布 器 ,帮助 读者 理解 Activity 的 建立 、 配 置 、 启 
动 与 关闭 过 程 ,然后 青 通过 在 实例 中 单 击 “ 已 有 商品 "页面 中 的 选项 , 跳 转 到 该 商品 修改 页 面 
这 个 功能 来 介绍 如 何 使 用 Bundle 在 Activity 之 间 传 递 数据 ,接着 ,通过 页 面 之 间 的 跳 转 时 
的 日 志 输 出 信息 来 理解 Activity 的 回调 机 制 和 生命 周期 。 


6.2.1 从 商品 发 布 器 的 启动 界面 理解 Activity 的 建立 配置 


首先 通过 查看 商品 发 布 器 源码 中 的 MainActivity 类 可 以 看 出 ,该 类 继承 自 Activity 基 
类 并 实现 了 android. view. View. OnClickListener 接口 ,也 就 是 说 , 想 要 使 一 个 类 成 为 
Activity 类 ,那么 我 们 需要 做 的 是 让 这 个 类 继承 Activity 类 ,这 与 开发 Web 应 用 时 建立 
Servlet 需要 继承 HttpServlet 类 似 。 当 然 ,在 有 特殊 需求 时 ,有 时 候 该 类 也 会 继承 Activity 
的 子 类 ,例如 ,继承 ListActivity 显示 列表 页 或 继承 TabActivity 实现 标签 页 效果 。 
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接 下 来 我 们 还 看 到 MainActivity 中 有 下 面 这 么 一 段 代 码 : 


GOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate( savedInstanceState); 
// 加 载 布局 文件 
setContentView(R.layout.activity main); 
init(); 

j) 


在 方法 上 加 上 了 @Override 注解 ,表示 该 方法 是 父 类 中 的 方法 ,也 就 是 说 ,此 处 实现 的 


onCreate ( Bundle savedInstanceState) 是 属于 重 写 Activity 类 中 的 该 方法 ,这 是 实现 
Activity 时 需要 实现 的 最 常见 的 方法 ,该 方法 将 会 在 Activity 启动 时 被 回调 ,这 与 开发 
Servlet 时 重 写 HttpServlet 的 doGet(…) 和 doPost(…) 方 法 类 似 。 在 onCreate (Bundle 
savedInstanceState) 方 法 体 中 可 以 看 到 setContentView CR. layout. activity. main) 这 行 代 
码 ,该 行 代码 将 布局 文件 activity main. xml 中 所 展示 的 View 显示 在 该 Activity 中 ,然后 再 
通过 自 定义 init() 方 法 去 获取 界面 中 各 个 组 件 以 及 修改 各 个 组 件 的 属性 和 方法 即 可 。 需 要 
特别 指出 的 是 ,创建 Activity 有 时 并 不 只 是 需要 重 写 onCreate 方法 而 已 ,而 是 需要 实现 多 
个 Activity 类 中 的 回调 方法 。 


在 本 应 用 实例 中 ,通过 开发 MainActivity, 实 现在 界面 单 击发 布 "按钮 从 而 将 界面 中 的 


EditText 控件 以 及 Spinner 控件 所 对 应 的 值 提交 到 后 台 程序 中 ,而 后 台 将 会 把 所 接收 到 的 
值 作为 商品 实体 的 属性 存放 到 数据 库 中 的 商品 表 中 ; 单 击 界面 中 的 “查看 已 有 商品 ?按钮 跳 
转 到 商品 列表 页 面 。 具 体 可 以 查看 本 书 所 附带 源码 中 该 实例 关于 MainActivity 的 实现 源 
码 , 此 处 不 再 歼 述 ,因为 这 些 源码 已 经 与 具体 的 业务 需求 挂钩 了 ,所 以 已 不 是 建立 Activity 
所 需要 做 的 通用 操作 了 。 


接 下 来 ,看 一 下 商品 发 布 器 中 是 如 何 配置 MainActivity 的 。 查 看 项 目 源码 全 局 配置 文 


件 AndroidManifest. xml, 代 码 如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 

< manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
package = "cn. edu. hstc. commodityrelease. activity" 
android:versionCode = "1" 
android:versionName = "1.0" > 


< uses - sdk 
android:minSdkVersion = "18" 
android:targetSdkVersion = "18" /> 


< application 

android:allowBackup = "true" 

android: icon = "@drawable/ic_launcher" 

android: label = "@string/app_name" 

android: theme = "@style/AppTheme" > 

<activity 
android:name = "cn. edu. hstc. commodityrelease. activity. MainActivity" 
android: label = "@ string/app_name" > 


(s Android 应 用 开发 从 入 门 到 精通 


«t -一 指定 该 Activity 是 程序 的 入 口 , 即 启 动 界面 --> 
< intent - filter» 


< action android:name = "android. intent. action. MAIN" /> 


< category android:name = "android. intent.category. LAUNCHER" /> 
«/intent- filter» 

«/activity» 

<! -- 定义 应 用 中 所 出 现 的 各 个 Activity, 必须 指定 其 nane 属性 --> 

« activity android:name = "cn. edu. hstc. commodityrelease. activity.ShowActivity" /> 

« activity android:name = "cn. edu. hstc. commodityrelease. activity. UpdateActivity" /> 
«/application» 
<! -- 定义 应 用 中 所 会 使 用 到 的 权限 --> 
< uses - permission android:name = "android. permission. ACCESS NETWORK STATE"/» 
< uses - permission android:name = "android. permission. INTERNET" /> 


</manifest > 


从 代码 中 可 以 看 到 ,开发 了 Activity 之 后 ,需要 在 全 局 配置 文件 中 定义 该 Activity, 具 
体 方法 是 为 < application/> 元 素 添加 < activity/> 子 元 素 。 应 用 中 建立 了 多 少 个 Activity, W 
需要 定义 多 少 个 < Activity/> 元 素 。 每 个 < Activity/> 元 素 都 需要 指定 name 属性 ,该 属性 的 
属性 值 为 该 Activity 类 在 项 目 中 的 全 称 ,例如 ,本 示例 中 的 cn. edu. hste. commodityrelease. 
activity. ShowActivity。 当 然 ,还 可 以 指定 其 他 属性 ,如 该 Activity 对 应 的 图 标 icon, 该 
Activity 的 标签 label 等 。 如 下 配置 片段 : 
«activity 
android:name = "cn. edu. hstc. commodityrelease. activity. MainActivity" 
android: icon = "(3)drawable/icon" 
android: label = "@string/app_name" > 
</activity> 
以 上 的 代码 在 配置 MainActivity 时 还 为 其 指定 了 一 个 < intent-filter/> 元 素 , 该 元素 用 
于 指定 该 Activity 相应 的 Intent。 例 如 代码 中 的 以 下 片段 : 
< intent - filter > 
< action android:name = "android. intent. action. MAIN" /> 
< category android:name = "android. intent. category. LAUNCHER" /> 
«/intent- filter > 
该 代码 片段 指定 了 MainActivity 为 程序 的 入 口 。 
至 此 ,如 何 建立 和 配置 Activity 已 全 部 介绍 完毕 。 


6.2.2 使 用 Bundle 将 信息 传递 到 商品 修改 页 面 


在 本 例 中 , 单 击 “ 查 看 已 有 商品 页面 中 的 某 一 条 数据 ,程序 将 会 获取 List View 中 该 条 
商品 信息 ,并 将 该 条 商品 的 ID、 名 称 、 分 类 、 价 格 都 传递 到 商品 修改 页 面 ,也 就 是 说 ,此 时 的 
页 面 跳 转 ,是 带 着 数据 信息 跳 转 的 。 本 例 中 跳 转 到 商品 修改 页 面 的 代码 片段 如 下 : 


listView.setOnItemClickListener(new OnItemClickListener() { 
(QOverride 
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public void onItemClick(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
Commodity commodity = commodityList.get(arg2); 
Bundle bundle = new Bundle(); 
bundle. putInt("theId", commodity.getTheId()); 
bundle. putString("name", commodity. getName()); 
bundle. putString("type", commodity.getType()); 
bundle. putString("price", commodity.getPrice()); 
Intent intent = new Intent(ShowActivity. this, UpdateActivity.class); 
intent. putExtras(bundle); 
startActivity(intent); 
ShowActivity.this.finish(); 


n; 


从 代码 中 可 以 看 到 ,商品 信息 是 存放 到 一 个 Bundle 对 象 中 的 ,Bundle 提供 了 多 个 方法 
来 存 人 数据 ,例如 代码 中 的 bundle. putInt("theld", commodity. getTheld()) 这 一 行 代码 以 
及 bundle. putString(" name". commodity. getName()) 这 一 行 代 码 。 其 实 , Bundle 还 提供 
了 很 多 其 他 的 类 似 存 人 Integer 类 型 和 String 类 型 的 方法 来 存 人 其 他 类 型 的 数据 ,语法 格 
式 为 : putXxx(String key, Xxx data), 

事实 上 ,Bundle 还 提供 了 一 个 putSerializable(String key. Serialiizable data) 的 方法 来 
存 人 一 个 可 序列 化 的 对 象 。 

接着 ,Activity 之 间 的 信使 一 一 Intent, 通 过 方法 putExtras(Bundle bundle) 将 存 人 了 数 
据 的 Bundle 对 象 引入 Intent 对 象 中 ,这 样 , 跳 转 时 便 将 相应 的 数据 传输 到 另 一 个 Activity 
中 。 如 上 面 代 码 片 段 中 的 intent. putExtras(bundle) 所 示 。 

为 了 在 另 一 个 Activity 中 能 够 取出 Bundle 所 携带 的 数据 ,Bundle 提供 了 以 下 方法 : 

æ getXxx(String key) 一 一 从 Bundle 中 取出 Integer, String 等 各 种 类 型 的 数据 ; 

 getSerializable(String key, Serialiizable data) 一 一 从 Bundle 中 取出 一 个 可 序列 化 的 

对 象 。 

在 商品 修改 页 面 中 取出 传递 过 来 的 商品 信息 的 代码 片段 如 下 ,读者 可 以 从 中 体会 上 面 
两 个 取 数 据 方法 中 的 第 一 个 。 

Intent intent = getIntent(); 

Bundle bundle intent.getExtras(); 

final Integer theld = bundle.getInt("theId"); 

String name - bundle.getString("name"); 


String type = bundle.getString("type"); 
String price = bundle.getString("price"); 


至 此 ,使 用 Bundle 在 Activity 间 传 递 信息 的 介绍 就 完毕 。 
6.2.3 理解 Activity 的 回调 机 制 以 及 生命 周期 


当 你 开发 了 一 个 Web 应 用 下 的 Servlet 并 运行 于 Web 服务 器 中 时 ,该 Servlet 何 时 创 
建 实例 , 何 时 回调 Servlet 的 方法 ,开发 者 是 无 法 控制 的 ,这 种 回调 由 服务 器 自行 决定 。 

而 Android 应 用 中 的 Activity 开发 类 似 于 Web 开发 中 的 Servlet 开发 ,Activity 被 开发 
出 来 后 ,开发 者 只 需 在 AndroidManifest. xml 文件 中 配置 该 Activity 即 可 。 至 于 该 Activity 
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何 时 被 实例 化 , 它 的 方法 何 时 被 调用 ,对 开发 者 来 说 是 透明 的 。 

在 不 同 的 场景 和 时 间 点 ,Android 将 会 调用 Activity 的 不 同 的 特定 的 方法 ,这 种 调用 就 
称 为 回调 。 当 然 , 想 要 实现 这 些 回调 ,Activity 开发 必须 继承 Activity 基 类 或 Activity 的 子 
类 ,继承 之 后 ,这 些 特定 的 方法 就 已 经 被 定义 了 ,如 6. 1 节 所 实现 的 商品 发 布 器 中 的 
ShowActivity 类 中 的 onCreate 方法 。 开 发 者 可 以 根据 业务 需求 选择 性 地 重 写 Activity 中 
的 方法 ,Activity 将 会 回调 这 些 特定 的 方法 来 完成 具体 的 业务 处 理 。 这 就 是 Activity 的 回 
调 机 制 。 

当 商 品 发 布 器 被 部 署 在 Android 系统 之 后 , 随 着 商品 发 布 器 的 运行 ,Activity 会 在 不 同 
的 状态 之 间 不 断 切换 ,该 Activity 中 特定 的 方法 就 会 被 回调 ,这 些 不 同 的 状态 就 构成 了 
Activity 的 生命 周期 。 

当 一 个 Activity 处 于 Android 应 用 中 运行 时 , 它 的 活动 状态 由 Android 以 Activity EZ 
的 形式 管理 。 当 前 活动 的 Activity 位 于 栈 顶 。 随 着 应 用 的 运行 阶段 的 不 同 ,每 个 Activity 
都 会 在 活动 状态 以 及 非 活动 状态 之 间 不 同 切换 。 总 结 起 来 Activity 大 致 有 以 下 四 个 状态 : 

。 活动 状态 一 一 当前 Activity 位 于 栈 顶 ,用 户 可 见 , 并 可 以 获得 焦点 。 

。 暂停 状态 一 一 其 他 Activity 位 于 栈 顶 ,但 该 Activity 依旧 可 见 , 只 是 不 能 获得 焦点 。 

* 停止 状态 一 一 该 Activity 不 可 见 并 且 失 去 焦点 。 

。 销毁 状态 一 一 该 Activity 结束 ,或 该 Activity 所 在 的 Dalvik 进程 被 结束 。 

下 面 通过 Android 官方 文档 中 的 一 张 经 典 的 生命 周期 流程 图 来 显示 Activity 生命 周期 
及 相关 的 回调 方法 ,如 图 6.4 所 示 。 

下 面 通过 改造 以 下 商品 发 布 器 查看 已 有 商品 页 面 所 对 应 的 Activity 一 ShowActivity 类 
的 源码 来 向 读者 展示 Activity 的 生命 周期 。 首 先 ,在 ShowActivity 类 中 的 onCreate 
(Bundle savedInstanceState) 方 法 中 加 入 一 行 代码 ,如 下 面 代码 片段 中 的 方 圈 里 的 内 容 
所 示 : 

@Override 


protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 














Log. i("ShowActivity", "------ onCreate 一 -一 一 一 一 "ys 

// 加 载 界面 布局 文件 

setContentView(R.layout.activity show); 

// 获 取 返 回 按钮 

backImg = (ImageView) findViewById(R. id. img back); 

// 为 返回 按钮 添加 事件 监听 器 

backImg. setOnClickListener(new View.OnClickListener() ( 
@Override 


public void onClick(View v) { 
ShowActivity.this.finish(); 

} 
n; 
Map < String, String» map = new HashMap < String, String»(); 
map. put("name", ""); 
// 请 求 后 台 GetConnoditys, 加 载 数据 并 完成 页 面 更 新 操作 
acquire(map, "数据 加 载 中 ..."，true, "GetCommoditys"); 
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图 6.4 Activity 的 生命 周期 以 及 回调 方法 














接着 ,在 ShowActivity 类 中 重 写 Activity 基 类 的 其 他 回调 方法 , 即 加 入 如 下 代码 片段 : 


(QOverride 
protected void onStart() ( 
super. onStart() ; 
Log. i("ShowActivity", "------ onStart -----— "s 


(QOverride 
protected void onRestart() ( 
super. onRestart() ; 
Log. i("ShowActivity", " ------ onRestart ------ yy 


(QOverride 
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protected void onResume() { 

super. onResune( ) ; 

Log. i("ShowActivity", "------ onResume 一 一 一 一 一 一 ");; 
f 


GOverride 
protected void onPause() ( 

super. onPause( ) ; 

Log. i("ShowActivity", "------ onPause 一 一 一 一 一 一 i 1 
} 


@Override 
protected void onStop() ( 

super. onStop() ; 

Log. i("ShowActivity", "------ onStop------ "s 
} 


@override 
protected void onDestroy() { 

super. onDestroy() ; 

Log. i("ShowActivity", "-----— onDestroy ------ "); 
d 


将 商品 发 布 器 重新 部 署 在 Android 模拟 器 上 ,运行 效果 如 图 6. 1 所 示 。 此 时 单 击 “ 查 看 
已 有 商品 ”按钮 ,应 用 将 会 跳 转 到 ShowActivity 页 ,如 图 6. 2 所 示 , 此 时 ,查看 Eclipse 的 
DDMS 面板 ,在 LogCat 窗口 过 滤 出 info 信息 .将 会 看 到 如 图 6. 5 所 示 的 输出 。 












ux 
1 089-13 07:22:01.469 621 621 com.example.commo...  ShowActiviz: 
1 09-13 07:22:01.469 — 621 621 com.example.commo...  ShowActivity 





-— 
Activity 启 动 时 的 回调 方法 


6.5 启动 Activity 时 回调 的 方法 
此 时 , 按 下 Android 模拟 器 上 的 Home 键 ,返回 系统 桌面 ,当前 Activity, 即 “查看 已 有 





















09-13 07:22:01.469 621 621 com.erample.como... Showàctivity 

1 09-13 07:38:56.428 621 621 com.example.commo...  ShowActivity 

1 09-13 07:38:57.179 621 621 com.example.commo...  ShowActivity 
Adtivity 暂 停 时 的 回调 方法 


6.6 暂停 Activity 时 回调 的 方法 


在 模拟 器 程序 列表 中 单 击 商品 发 布 器 图 标 , 此 时 重新 回 到 按 下 Home 键 之 前 的 页 面 ， 
也 就 是 “查看 已 有 商品 ”页 面 ShowActivity, 该 Activity 重新 变 为 活动 状态 ,可 以 看 到 
LogCat 窗口 中 有 如 图 6. 7 所 示 输 出 。 
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22:01.469 621 621 com.example.commo 





1 0513 

1 09-13 07:22:01.469 — 621 621 com.example.commo... ShowActivity 
1 09-13 07:38:56.428 621 621 com.example.commo... ShowActivicy 
1 09-13 07:38:57.179 621 621 com.example.commo... ShowActivity 
1 09-13 07:43:48.460 621 621 com.example.commo... ShowActivity 
1 08-13 07:43:48.460 — 621 621 com.example.commo... ShowActivity 
1 08-13 07:43:48.469 621 621 com.example.commo... ShowActivity 














- 
Activity 重 新 启动 时 的 回调 方法 


6.7 重启 Activity 时 回调 的 方法 


单 击 “ 查 看 已 有 商品 "页面 中 的 商品 列表 中 的 任意 一 条 数据 , 跳 转 到 商品 修改 页 面 ,依据 程 
序 设 定 ,此 时 将 会 结束 掉 “ 查 看 已 有 商品 ”页面 ,可 以 看 到 LogCat 窗口 中 有 如 图 6. 8 所 示 输 出 。 














1 09-13 07:22:01.229 621 621 com.example.commo... Showictivity —— --—---- onCreate—-— 
1 09-13 07:22:01.469 621 621 com.example.commo...  ShowActivity -onStart-— 

1 09-13 07:22:01.469 621 621 com.example.commo...  ShowActivity -onResume-— 

1 09-13 07:38:56.428 — 621 621 com.example.commo... ShowActivity  ------ onPause---—--— 
1 09-13 07:38:57.179 621 621 com.cxample.commo...  ShowAcrivity onstop. 

1 09-13 07:43:48.460 621 621 com.example.commo...  ShowActivity 

1 09-13 07:43:48.460 621 621 com.example.commo... ShowActivity 

1 09-18 07:43:48.469 621 621 com.example.commo... ShowActivity 

1 09-13 07:48:31.379 — 621 621 com.erample.commo...  ShowActivity 

1 09-13 07:48:31.900 621 621 com.ezample.commo...  ShowActivity 

1 09-13 07:48:31.900 621 621 com.example.commo...  ShowActivity 





结束 Adtivity 时 的 回调 方法 


6.8 关闭 Activity 时 回调 的 方法 


通过 上 面 的 演示 ,相信 读者 对 Activity 的 生命 周期 状态 及 在 不 同 状态 之 间 切 换 时 所 回 
调 的 方法 有 了 清晰 的 认识 。 归 纳 如 下 : 

onCreateCBundle savedInstanceState) 一 一 创建 Activity 时 被 回调 。 

aonStart O 一 一 启动 Activity 时 被 回调 。 

局 onRestart() 一 一 重新 启动 Activity 时 被 回调 。 

局 onResume() 一 一 恢复 Activity 时 被 回调 。 

名 onPause() 一 一 暂停 Activity 时 被 回调 。 

名 onStop() 一 一 停止 Activity 时 被 回调 。 

名 onDestroy() 一 一 销毁 Activity 时 被 回调 。 


6.3 本 章 小 结 


本 章 详细 介绍 了 Android 四 大 组 件 之 一 的 Activity, Activity 开发 是 Android 开发 中 
最 常见 的 开发 。 本 章 介绍 商品 发 布 器 的 开发 ,重点 掌握 如 何 开发 Activity 以 及 如 何在 
AndroidManifest. xml 全 局 配置 文件 中 配置 Activity。 由 于 Android 应 用 通常 会 由 多 个 
Activity 组 成 ,因此 读者 必须 掌握 如 何 利用 Bundle 在 不 同 Activity 之 间 传 递 数 据 。Activity 
具有 自身 的 生命 周期 ,读者 需要 对 此 有 清晰 的 了 解 。 
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通过 计时 器 详细 介绍 Service 及 
BroadcastReceiver | 


本 章 通过 计时 器 这 个 小 应 用 的 实现 来 向 读者 介绍 Android 四 大 组 件 中 的 Service 以 及 
BroadcastReceiver, 7.1 节 介绍 实现 开发 计时 器 的 流程 以 及 代码 ,7. 2 节 通 过 齐 析 计时 器 介 
绍 Service 和 BroadcastReceiver 的 创建 .配置 .启动 等 知识 点 。 本 章 亦 会 涉及 Service 的 更 
多 知识 点 以 及 系统 级 的 广播 消息 等 。 


6.1 实现 计时 器 


本 节 的 主要 内 容 是 介绍 计时 器 的 实现 流程 及 代码 。 首 先 , 该 计时 器 的 需求 是 当 用 户 单 
击 程序 列表 中 的 计时 器 应 用 图 标 时 ,将 会 以 Android 对 话 框 的 形式 弹出 一 个 小 窗 体 ,在 该 窗 
体 中 放置 一 个 显示 已 过 时 间 的 文本 输入 框 ,该 输入 不 可 编辑 ,在 该 文本 框 正 下 方 放置 一 个 按 
钮 , 单 击 即 可 开始 计时 ,并 将 已 过 时 间 实 时 显示 在 文本 输入 框 中 ,时 间 精 确 到 秒 ,用 户 在 此 单 
击 该 按钮 可 停止 计时 。 
在 Eclipse 中 新 建 一 个 Android 应 用 工程 ,填写 好 应 用 名 称 、 工 程 名 称 、 包 名 等 相关 信 
息 , 选 择 SDK 版 本 ,完成 其 他 相关 操作 , 单 击 Finish 按钮 ,项 目 工程 便 初始 化 完毕 。 所 谓 计 
时 器 ,就 是 为 了 向 用 户 展示 已 用 时 间 , 因 而 显示 界面 必 不 可 少 , 新 建 一 个 Layout 布局 文件 ， 
完成 计时 器 与 用 户 交 互 的 布局 界面 的 代码 编辑 ,界面 代码 如 下 : 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width- "fill parent" 
android:layout height - "fill parent" 


android:orientation = "vertical" 
android:padding = "10dp" > 


< LinearLayout 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< TextView 
android:layout width- "wrap content" 
android:layout height - "wrap content" 
android:text = "已 经 过 : " /> 


第 7 章 ”通过 计时 器 详细 介绍 Service 及 BroadcastReceiver 


<EditText 

android:id- "(à + id/edit time" 
android:layout width = "131.5dp" 
android:layout height = "wrap content" 
android:background = "(2drawable/contact edit edittext normal" 
android:cursorVisible - "false" 
android:paddingLeft = "2. 5dp" 
android:editable - "false" /» 

«/LinearLayout > 


« Button 
android:id- "(9 + id/button" 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
android:layout marginTop = "6dp" 
android:background = "(2drawable/style button" 
android:text = "开始 计时 "”/> 


</LinearLayout > 
代码 文件 : codes\07\7.1\CountDemo\res\layout\activity_main. xml 

以 上 代码 为 界面 中 的 文本 输入 框 设置 了 一 个 background 属性 ,该 属性 值 是 一 个 
drawable 样式 资源 contact_edit_edittext_normal. xml, 在 该 资源 文件 中 自 定 义 了 文本 框 的 
样式 ,读者 可 以 在 本 书 附带 源码 中 查看 该 资源 文件 源码 。 在 代码 中 亦 将 该 文本 输入 框 设 置 
为 光标 隐藏 并 且 不 可 编辑 , 即 用 户 单 击 该 文本 输入 框 , 并 不 会 弹出 Android 键盘 供用 户 输 
入 。 界 面 中 所 放置 的 Button 控件 的 样式 通过 样式 资源 文件 style button. xml 实现 自 定义 ， 
读者 也 可 通过 学 习 本 书 附带 案例 源码 获得 该 文件 代码 。 

本 计时 器 有 一 个 特殊 要 求 ,就 是 当 用 户 按 下 Android 硬 键盘 上 的 Home 键 时 ,即使 计时 
器 界面 此 时 已 消失 ,不 再 与 用 户 交 互 ,但 计时 功能 仍 在 后 台 继 续 进行 , 当 用 户 重 新 单 击 程序 
列表 中 的 计时 器 图 标 时 ,将 会 把 界面 重新 调 到 前 台 , 输 入 框 将 显示 之 前 总 共 经 过 的 时 间 并 继 
续 计 时 。 要 实现 该 需求 ,就 必须 使 用 到 Android 四 大 组 件 之 一 : Service 组 件 ,将 计时 的 核 
心 程序 放置 在 一 个 自 定义 的 Service 类 中 。 该 Service 类 的 实现 代码 如 下 : 


package cn. edu. hstc. countdemo. service; 


import java. text.SimpleDateFormat; 
import java. util. Date; 

import java.util.Timer; 

import java. util. TimerTask; 


import android. app. Service; 

import android. content. ComponentName; 
import android. content. Intent; 

import android. os. Bundle; 

import android. os. IBinder; 

import android. util. Log; 
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public class TimeService extends Service { 

private static String TIME CHANGED ACTION = "cn. edu. hstc. service. action. TIME CHANGED 
ACTION"; 

private Timer timer - null; 

private Intent timeIntent - null; 

private Bundle bundle = null; 

private SimpleDateFormat sdf - null; 

private boolean flag = true; 


(QOverride 
public void onCreate() ( 
super. onCreate() ; 


Log. i("TimeService", "------ onCreate 一 一 一 一 一 一 ys 
this. init(); // 初 始 化 
timer. schedule(new TimerTask() ( // 定 时 器 发 送 广播 
(QOverride 
public void run() ( 
if (flag) { 
sendTimeChangedBroadcast() ; // 发 送 广播 
) eise ( 


timer.cancel(); 
timer. purge() ; 
timer - null; 


) 
), 1000, 1000); 


(QOverride 
public void onStart(Intent intent, int startId) ( 
super.onStart(intent, startId); 


Log. i("TimeService", "------ onStart ------ 5); 

) 

(2Override 

public int onStartCommand(Intent intent, int flags, int startlId) ( 
Log. i("TimeService", "------ onStartCommand 一 一 一 一 一 一 "3; 
return super.onStartCommand(intent, flags, startId); 

) 

(SOverride 

public IBinder onBind(Intent intent) { 
Log. i("TimeService", "------ onBind------ "Jy 
return null; 

) 

(QOverride 

public boolean onUnbind(Intent intent) ( 


Log. i("TimeService", "------ onUnbind ------ er 
return super. onUnbind( intent) ; 
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/ xx 
* 相关 变量 初始 化 
*/ 
private void init() { 
timer = new Timer(); 
sdf = new SimpleDateFormat("yyyy - MM - dd HH:mm:ss. SSS"); 
timeIntent = new Intent(); 
bundle = new Bundle(); 
} 


/ xx 
* 发 送 广播 ,通知 UI 层 时 间 已 改变 
*/ 
private void sendTimeChangedBroadcast() { 
bundle. putString("time", getTime()); 
timeIntent. putExtras(bundle); 
timeIntent. setAction(TIME CHANGED ACTION); 
// 发 送 广播 ,通知 UI 层 时 间 改 变 了 
sendBroadcast(timeIntent); 
) 


/*x 
* 获取 最 新 系统 时 间 
*/ 
private String getTime() { 
return sdf. format(new Date( )); 
) 


(QOverride 

public ComponentName startService(Intent service) ( 
Log. i("TimeService", "------ startService ------ "js 
return super. startService(service); 


) 


(&Override 

public void onDestroy() { 
super. onDestroy(); 
Log. i("TimeService", "------ onDestroy ------ "ys 
flag - false; 

) 


代码 文件 : codes\07\7.1\CountDemo\cn\edu\hstc\countdemo\service\TimeService. java 


上 面 程序 实现 了 一 个 可 运行 于 后 人 台 的 Service 组 件 ,该 Service 负责 通过 一 个 定时 器 
Timer 每 一 秒 钟 发 送 一 个 广播 ,并 且 该 广播 在 传播 过 程 中 将 带 着 系统 当前 最 新 的 时 间 。 当 
该 Service 被 销毁 的 时 候 , 该 定时 器 将 不 再 发 送 广播 。 

在 实现 TimeService 类 的 源码 之 后 ,还 需要 在 Android 全 局 配置 文件 中 对 该 Service 进 
行 配置 ,如 下 : 
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<?xml version = "1.0" encoding = "utf - 8"?» 

< manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
package = "cn. edu. hstc. countdemo. activity" 
android:versionCode - "1" 
android:versionName = "1.0" > 


< uses - sdk 
android:minSdkVersion - "8" 


android:targetSdkVersion - "8" /» 


« application 

android:allowBackup = "true" 
icon = "(Qdrawable/ic launcher" 
android: label = "(Qstring/app name" 
android: theme = "(à style/AppTheme" > 
<activity 





androi 


android:name = "cn. edu. hstc. countdemo. activity. MainActivity" 
android: theme = "@android: style/Theme. Dialog" > 
< intent - filter > 

<action android:name = "android. intent. action. MAIN" /> 


< category android:name = "android. intent. category. LAUNCHER" /> 
</intent - filter» 

«/activity» 

« activity android:name = "cn. edu. hstc. countdemo. activity. SecondActivity" /> 

< service android:name = "cn. edu. hstc. countdemo. service. TimeService"» 

< intent - filter android: name = "cn. edu. hstc. service. action. TIME CHANGED _ 
ACTION"? «/intent - filter > 

«/service» 

«/application» 


</manifest > 
代码 文件 : codes\07\7.1\CountDemo\res\AndroidManifest. xml 


有 了 该 Service 不 断 记 录 当 前 最 新 时 间 , 为 了 实现 不 断 告 诉 用 户 该 时 间 和 一 开始 单 击 
“开始 计时 ”按钮 时 获取 的 时 间 的 时 间 差 ,必须 采用 一 个 Activity 与 用 户 进 行 交互 。 新 建 一 
个 MainActivity 类 ,实现 代码 如 下 : 


package cn. edu. hstc. countdemo. activity; 


import java. text. DateFormat; 
import java. text. ParseException; 
import java. text. SimpleDateFormat; 
import java.util.Date; 


import android. app. Activity; 

import android. content. BroadcastReceiver; 
import android. content. Context; 

import android. content. Intent; 

import android. content. IntentFilter; 
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import android. graphics. Color; 

import android. os. Bundle; 

import android. view. View; 

import android. view. Window; 

import android. view. WindowManager; 

import android. widget. Button; 

import android. widget. EditText; 

import cn. edu. hstc. countdemo. service. TimeService; 


public class MainActivity extends Activity ( 


private static String TIME CHANGED ACTION = "cn. edu. hstc. service. action. TIME CHANGED 


ACTION"; 
private EditText timeEdit = null; 
private Button button = null; 
private Intent serviceIntent - null; 
private DateFormat df = new SimpleDateFormat("yyyy — MM - dd HH:mm:ss. SSS"); 
private Date startDate = null, currentDate = null; 


(QOverride 
public void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 


this. getWindow ( ). setFlags (WindowManager. LayoutParams. FLAG ^ FULLSCREEN, 


WindowManager.LayoutParams.FLAG FULLSCREEN); 
this.requestWindowFeature(Window.FEATURE NO TITLE); 
setContentView(R. layout.activity main); 

// 初 始 化 布局 上 的 控件 Widget 
initWidget(); 
// 注 册 广 播 ,监听 后 台 Service 发 送 过 来 的 广播 


registerBroadcastReceiver(); 


private class TimeReceiver extends BroadcastReceiver ( 
(3)0verride 
public void onReceive(Context context, Intent intent) ( 
String action - intent.getAction(); 
if (action!- null && TIME CHANGED ACTION. equals(action)) { 
String currentTime - intent.getExtras().getString("time"); 
try ( 
currentDate = df.parse(currentTime); 
) catch (ParseException e) { 
e. printStackTrace(); 
) 
long diff = currentDate.getTime() — startDate.getTine(); 


// 这 样 得 到 的 差 值 是 微 秒 级 别 


long days = diff / (1000 * 60 * 60 * 24); 
long hours = diff / (60 * 60 * 1000) - days * 24; 
long mins = (diff / (60 + 1000)) — days * 24 * 60 — hours * 60; 


longs = diff / 1000 — days * 24 * 60 * 60 — hours * 60 * 60 — mins * 60; 
String diffTimeStr = days + "K" + hours + "小 时 ”+ mins + "分 ”+ s + "fb"; 


timeEdit.setText(diffTimeStr); 
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/ax 
* Wie ur 
*/ 
private void initWidget() { 
timeEdit = (EditText) findViewById(R. id. edit time); 
timeEdit. setTextColor(Color.RED); 
timeEdit. setTextSize(13); 
button = (Button) findViewById(R. id. button); 
button. setOnClickListener(new View.OnClickListener() { 
(QOverride 
public void onClick(View v) { 
if (button. getText(). toString(). equals("JF fi] BE") ) ( 
// 启 动 服务 ,时 间 改变 后 发 送 广播 ,通知 UI 层 修改 时 间 
try { 
String nowDateStr = df.format(new Date()); 
startDate = df.parse(nowDateStr); 
) catch (ParseException e) ( 
e. printStackTrace(); 
} 
startTimeService( ); 
button. setText(" 停 止 计时 "); 
} else if (button. getText(). toString().equals(" 停 止 计时 ")) { 
stopService(serviceIntent); 
serviceIntent - null; 
startDate = null; 
currentDate = null; 
button. setText(" 开 始 计 时 "); 


} 
} 
n; 
) 
/ xx 
* 注册 广播 
*/ 


private void registerBroadcastReceiver() { 
TimeReceiver receiver = new TimeReceiver(); 
IntentFilter filter - new IntentFilter(TIME CHANGED ACTION); 
registerReceiver(receiver, filter); 


/ xx 
* 启动 服务 
*/ 
private void startTimeService() { 
serviceIntent = new Intent(this, TimeService.class); 
this.startService(serviceIntent); 
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@Override 
protected void onDestroy() { 
super. onDestroy() ; 


// 停 止 服务 

if (serviceIntent!- null) ( 
stopService(serviceIntent); 
serviceIntent = null; 


代码 文件 : codes\07\7.1\CountDemo\cn\edu\hstc\countdemo\activity\MainActivity. java 


上 面 程序 实现 当 用 户 单 击 Activitiy 中 的 “开始 计时 ”按钮 时 ,记录 下 此 时 系统 当前 时 间 
并 启动 服务 TimeService,TimeService 开始 将 更 新 的 时 间 通 过 广播 发 送出 去 , MainActivity 
中 的 注册 的 广播 接收 者 开始 不 断 监听 TimeService 发 来 的 广播 并 将 接收 到 的 广播 Intent 中 
所 带 的 时 间 和 记录 的 开始 时 间 进 行 比较 ,算出 时 间 差 并 将 该 时 间 差 显示 在 页 面 中 的 文本 输 
入 框 中 。 当 用 户 单 击 “ 停 止 计时 ”按钮 时 ,将 停止 TimeServie, 触 发 TimeService 的 销毁 事件 
控制 TimeService 中 的 定时 器 不 再 发 送 广 播 。 

为 了 使 该 Activity 以 对 话 框 Dialog 的 形式 启动 ,需要 在 Android 的 全 局 配置 文件 中 配 
TE Activity 的 主题 样式 。 





<?xml version = "1.0" encoding = "utf 一 8"?> 

« manifest xmlns:android = "http://schemas. android. com/apk/res/android" 
package = "cn. edu. hstc. countdemo. activity" 
android:versionCode = "1" 
android:versionName = "1.0" > 


< uses - sdk 
android:minSdkVersion - "8" 
android:targetSdkVersion = "8" /> 


<! -- 通过 android:theme = "(android:style/Theme. Dialog" 指 定 Activity 的 主题 资源 为 对 话 
框 主题 --> 
<application 
android:allowBackup = "true" 
android: icon = "(Qdrawable/ic launcher" 
android: label = "@string/app_name" 
android: theme = "@style/AppTheme" > 
<activity 
android:name = "cn. edu. hstc. countdemo. activity.MainActivity" 
android: theme = "(2android:style/Theme. Dialog" > 
< intent - filter? 
« action android:name = "android. intent. action. MAIN" /> 


< category android:name = "android. intent. category. LAUNCHER" /> 
«/intent- filter» 
«/activity» 
< activity android:name = "cn. edu. hstc. countdemo. activity.SecondActivity" /> 
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< service android:name = "cn. edu. hstc. countdemo. service. TimeService"» 
< intent - filter android: name = "cn. edu. hstc. service. action. TIME CHANGED _ 
ACTION" «/ intent - filter > 
«/service» 


«/application» 


«/nanifest > 


代码 文件 : codesV07 V7. 1NCountDemoV res VAndroidManifest. xml 
将 应 用 部 署 在 Android 模拟 器 上 ,运行 效果 如 图 7. 1 所 示 。 
用 户 单 击 “ 开 始 计时 ”按钮 ,计时 器 开始 计时 ,效果 图 如 图 7. 2 所 示 o 
dam e 7:11am 


BME 7:124 





图 7.1 启动 计时 器 图 7.2 开始 计时 


至 此 ,计时 器 的 全 部 实现 代码 已 介绍 完毕 , 接 下 来 将 对 该 计时 器 进行 剖析 ,介绍 计时 器 
中 所 使 用 到 的 Service 和 BroadcastReceiver 的 一 些 特性 。 


7.2 齐 析 计时 器 


Service 作为 Android 组 件 , 与 window 中 的 服务 是 类 似 的 ,Service 一 般 没 有 用 户 操 作 
界面 ,运行 于 系统 中 不 易 被 用 户 发 现 ,可 以 使 用 它 开 发 监控 程序 等 。 一 旦 Service 被 启动 起 
来 , 它 就 与 Activity 一 样 有 了 自己 的 生命 周期 。 

广播 接收 者 BroadcastReceiver 用 于 接收 广播 Intent, 通 常 一 个 广播 可 以 被 订阅 了 该 广 
播 Intent 的 多 个 广播 接收 者 接收 。BroadcastReceiver 就 如 一 个 全 局 的 事件 监听 器 ,监听 着 
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系统 发 出 的 Broadcast。 
接 下 来 ,通过 剖析 计时 器 的 源 代码 中 关于 TimeService 和 BroadcastReceiver 的 开发 来 
介绍 这 两 者 的 相关 特性 。 


7.2.1 计时 服务 TimeService 的 创建 .配置 


查看 计时 器 中 TimeService 的 实现 源码 ,可 以 发 现 该 类 继承 自 Service 基 类 ,并 重 写 了 
onCreate() 方 法 和 onDestroy() 方 法 。 这 说 明 开 发 Service 组 件 的 第 一 个 必要 的 步骤 就 是 定 
义 一 个 继承 Service 类 的 子 类 。 

TimeService 重 写 了 onCreate() 方 法 和 onDestroy() 方 法 ,这 两 个 方法 其 实 都 是 属于 
Service 的 生命 周期 方法 ,关于 Service 的 生命 周期 ,将 会 在 后 面 单独 介绍 ,此 处 不 再 

接 下 来 ,查看 AndroidManifest. xml 文件 源码 ,可 以 发 现 其 中 有 这 样 一 行 代码 : 
< service android: name= "cn. edu. hstc. countdemo. service. TimeService"></service >, 该 
行 代码 配置 了 TimeService。 这 正 是 开发 Service 的 第 二 个 必要 的 步 又 一 一 在 
AndroidManifest. xml 中 配置 Service。 

事实 上 ,配置 Service 时 也 可 以 为 < service/> 元 素 配 置 <intent-filter/> 子 元 素 , 用 于 说 明 
该 Service 可 被 哪些 Intent 启动 。 如 下 配置 片段 : 

< service android:name = "cn. edu. hstc. countdemo. service. TimeService"> 

< intent - filter android: name = "cn. edu. hstc. service. action. TIME CHANGED, ACTION"» «/ 


intent - filter? 
«/service» 


7.2.2 计时 服务 TimeService 的 启动 和 停止 


一 个 服务 开发 好 了 ,比如 由 访问 者 去 启动 该 服务 。 在 计时 器 这 个 案例 中 ,是 通过 
MainActivity 去 启动 服务 的 , 单 击 MainActivity 中 的 “开始 计时 ”按钮 ,将 会 启动 
TimeService 服务 。 查 看 MainActivity 类 ,有 如 下 代码 片段 : 

[xx 

* 启动 服务 
*/ 
private void startTimeService() { 
serviceIntent - new Intent(this, TimeService.class); 


this. startService(serviceIntent); 


} 

该 方法 通过 上 下 文 对 象 Context. startService() 方 法 启动 TimeService 服务 。 需 要 强调 
的 是 ,通过 该 方法 启动 的 Service 与 访问 者 没有 关联 ,即使 访问 者 退出 了 ,Service 仍然 运行 。 

实际 上 ,还 可 以 通过 Context. bindService() 方 法 来 启动 一 个 Service, 这 时 访问 者 与 
Service 绑 定 在 一 起 ,访问 者 一 旦 退出 , Service 也 就 终止 。 接 下 来 将 继续 介绍 通过 
bindService() 方 法 来 启动 Service 的 情况 。 

当 用 户 单 击 “ 停 止 计时 ”按钮 时 ,程序 将 会 终止 TimeService 服务 的 运行 ,实现 停止 计 
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时 。 在 我 们 的 代码 中 ,停止 TimeService 十 分 简单 ,通过 代码 行 stopService(serviceIntent) 
便 可 停止 TimeService 计时 服务 的 运行 。 所 以 , 当 想 要 停止 一 个 通过 Context. startServiceO 77 
法 启动 的 服务 时 ,只 需 调 用 Context. stopService() 方 法 。 通 过 Context. bindService() 方 法 
启动 服务 , 则 需要 通过 Context. unbindService() 方 法 来 解 绑 服务 ,这 在 下 面 将 会 有 所 介绍 。 


7.2.3 计时 器 里 的 广播 接收 者 (BroadcastReceiver) 的 创建 配置 、 
启动 


BroadcastReceiver 用 于 接收 包括 用 户 开发 的 程序 和 系统 内 建 的 程序 所 发 出 的 
Broadcast Intent。 在 此 ,我 们 暂 不 关心 计时 器 里 的 广播 接收 者 BroadcastReceiver 接收 的 广 
播 来 自 哪里 ,此 时 关心 的 是 如 何 接收 广播 。 

为 了 能 够 接收 程序 所 发 出 的 广播 Intent, 我 们 需要 自 定义 自己 的 BroadcastReceiver。 
本 例 中 ,MainActivity 类 中 有 以 下 代码 片段 : 


private class TimeReceiver extends BroadcastReceiver { 
@Override 
public void onReceive(Context context, Intent intent) ( 
String action = intent.getAction(); 
if (action!- null && TIME CHANGED ACTION. equals(action)) { 
String currentTime - intent.getExtras().getString("time"); 
try { 
currentDate = df.parse(currentTime); 
) catch (ParseException e) ( 
e. printStackTrace(); 
) 
long diff = currentDate.getTime() - startDate.getTime(); 
// 这 样 得 到 的 差 值 是 微 秒 级 别 
long days = diff / (1000 * 60 * 60 * 24); 
long hours - diff / (60 * 60 * 1000) - days * 24; 
long mins - (diff / (60 * 1000)) - days * 24 * 60 - hours * 60; 
longs = diff / 1000 - days * 24 * 60 * 60 - hours * 60 * 60 - mins * 60; 
String diffTimeStr = days + "X" + hours + "小 时 ”+ mins + "分 " + s + "fb"; 
timeEdit. setText(diffTimeStr); 


) 
从 以 上 程序 中 可 以 看 出 , 自 定义 广播 接收 者 类 继承 自 BroadcastReceiver 基 类 并 实现 


onReceive(Context context, Intent intent) 方 法 。 
为 了 让 开发 出 来 的 BroadcastReceiver 能 够 监听 特定 的 广播 Intent, 需 要 为 其 注册 广 
播 。 如 MainActivity 类 中 的 代码 片段 : 


/ xx 
* 注册 广播 
*/ 
private void registerBroadcastReceiver() { 
TimeReceiver receiver - new TimeReceiver(); 
IntentFilter filter - new IntentFilter(TIME CHANGED ACTION); 
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registerReceiver(receiver, filter); 
} 
从 以 上 代码 片段 可 以 看 出 ,最 终 调用 的 是 registerReceiver(BroadcastReceiver receiver. 
IntentFilter filter) 方 法 为 广播 接收 者 注册 广播 。 
实际 上 ,我 们 还 有 另 一 种 注册 广播 的 方式 供 开发 者 选择 ,在 本 例子 中 的 广播 接收 者 类 是 
作为 MainActivity 类 的 内 部 类 的 ,如 果 自 定义 BroadcastReceiver 时 采用 的 是 外 部 类 方式 ， 
也 可 按照 以 下 配置 片段 实现 广播 接收 者 的 注册 


< receiver android:name = ".TimeReceiver"» 
< intent - filter» 
< action android:name = "cn. edu. hstc. service. action. TIME CHANGED ACTION" /> 
«/ intent - filter» 

«/receiver > 

BroadcastReceiver 本 质 上 是 一 个 系统 级 的 监听 器 ,拥有 自己 的 进程 ,只 要 存在 与 之 匹 
配 的 广播 Intent 被 广播 出 来 ,BroadcastReceiver 便 会 被 激发 。 每 次 系统 广播 事件 发 生 后 ， 
系统 就 会 创建 BroadcastReceiver 的 实例 ,并 自动 触发 它 的 onReceive (Context context, 
Intent intent) 方 法 ,该 方法 执行 完 后 , BroadcastReceiver 的 实例 就 会 被 销毁 。 

因此 ,BroadcastReceiver 无 须 开 发 者 控制 启动 ,而 是 在 特定 的 时 间 点 ,由 Android 系统 
自身 激发 。 

如 果 onReceive(Context context. Intent intent) 方 法 在 10s 内 未 被 执行 完成 , Android 
会 认为 该 程序 无 响应 。 所 以 不 要 在 该 方法 中 执行 一 些 耗 时 的 操作 ,否则 会 弹出 Application 
No Response 的 对 话 框 。 如 果 确 实 需要 由 BroadcastReceiver 来 完成 一 项 耗 时 的 操作 , 则 可 
以 在 onReceive(Context context, Intent intent) 方 法 中 启动 一 个 Service 来 完成 。 但 不 要 考 
虑 用 新 线程 去 完成 耗 时 操作 ,因为 BroadcastReceiver 本 身 的 生命 周期 很 短 , 可 能 出 现 子 线 
程 还 没有 结束 ,BroadcastReceiver 就 已 经 退出 的 情况 。 如 果 BroadcastReceiver 所 在 的 进程 
结束 ,虽然 该 进程 还 有 用 户 启 动 的 新 线程 ,但 由 于 该 进程 不 包含 任何 活动 组 件 , 因 此 系统 可 
能 在 内 存 紧张 时 优先 结束 该 进程 ,这 样 就 可 能 导致 BroadcastReceiver 启动 的 子 线程 不 能 执 
行 完成 。 


7.2.4 发 送 广播 以 及 广播 类 型 


当 用 户 单 击 “开始 计时 ?按钮 时 ,将 会 在 后 台 启 动 计时 服务 ,计时 服务 开启 了 一 个 定时 器 
不 断 的 发 送 广播 Intent. 该 Intent 带 着 最 新 的 当前 时 间 , 由 上 节 所 介绍 的 广播 接收 者 
BroadcastReceiver 接收 。 也 就 是 说 ,该 广播 是 由 服务 发 出 的 ,于 是 我 们 在 TimeService 类 中 
可 以 看 到 以 下 代码 片段 : 


/ xx 
* 发 送 广播 , 通知 UI 层 时 间 已 改变 
*/ 
private void sendTimeChangedBroadcast() { 
bundle. putString("time", getTime()); 
timeIntent. putExtras(bundle); 
timeIntent.setAction(TIME CHANGED ACTION); 
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// 发 送 广播 ,通知 UI 层 时 间 改 变 了 
sendBroadcast(timeIntent); 
) 
以 上 程序 中 的 TIME CHANGED ACTION 为 一 个 字符 串 常量 ,在 MainActivity 的 广 
播 接收 者 也 必须 是 IntentFilter 为 该 常量 的 才能 监听 到 该 广播 。 如 下 代码 片段 : 


< receiver android:name = ". TimeReceiver"> 
< intent - filter» 
« action android:name = "cn. edu. hstc. service. action. TIME CHANGED ACTION" /> 
«/intent - filter» 
</receiver > 
由 于 该 BroadcastReceiver 所 注册 的 IntentFilter 的 action 属性 值 与 上 面 的 广播 Intent 
的 action 值 一 样 , 故 该 BroadcastReceiver 可 被 该 广播 所 激活 。 
由 以 上 代码 可 以 看 出 ,发送 广播 非常 简单 ,只 需要 调用 Context. sendBroadcast (Intent 
intent) 方 法 。 这 条 广播 将 会 启动 intent 参数 所 对 应 的 BroadcastReceiver。 
事实 上 ,通过 Context. sendBroadcast(Intent intent) 方 法 所 发 送 的 广播 为 普通 广播 ,而 
广播 还 有 另外 一 种 类 型 叫 有 序 广播 。 发 送 有 序 广播 调用 的 是 另外 的 一 个 方法 ,这 也 就 涉及 
接 下 来 所 要 介绍 的 广播 的 类 型 。 
Broadcast 分 为 如 下 两 种 类 型 ; 
4 Normal Broadcast( 普 通 广播 ) 一 一 异步 广播 ,可 以 在 同一 个 时 刻 被 多 个 广播 接收 者 
所 接收 ,消息 传递 效率 较 高 。 不 足 之 处 是 接收 者 不 能 将 处 理 结果 传递 给 下 一 个 接收 
者 ,并 且 无 法 终止 广播 Intent 的 传播 。 
4 Ordered Broadcast( 有 序 广播 ) 一 一 接收 者 按照 预先 声明 的 优先 级 依次 接收 有 序 广 
播 , 优 先 级 高 的 优先 接收 到 有 序 广播 ,并 将 该 广播 传递 到 下 一 个 优先 级 的 接收 者 。 优 
先 级 声明 配置 在 < intent-filter/> 元 素 的 android: priority 属性 中 ,数值 越 大 ,优先 级 
别 越 高 , 值 的 范围 为 一 1000 一 1000, 优 先 级 别 也 可 以 调用 IntentFilter 对 象 的 
setPriority() 方 法 进行 设置 。 有 序 广播 的 接收 者 可 以 终止 该 广播 的 传播 ,使 后 面 的 接 
收 者 将 不 再 接收 到 该 Broadcast。 另 外 ,有 序 广播 的 接收 者 可 以 将 数据 传递 到 下 一 个 
接收 者 。 
在 以 上 的 程序 片段 中 ,发 送 普 通 广 播 所 调用 的 方法 为 Context. sendBroadcast (Intent 
intent) ,而 发 送 有 序 广播 所 调用 的 方法 则 为 Context. sendOrderedBroadcast(Intent intent) 。 
有 序 广播 接收 者 通过 BroadcastReceiver 的 abortBroadcast() 方 法 终止 广播 Intent fj 
续 传 播 。 优 先 接收 到 广播 的 接收 者 通过 setResultExtras(Bundle bundle) 方 法 将 处 理 结果 
HAT k Broadcast 中 ,下 一 个 接收 者 可 通过 代码 Bundle bundle = getResultExtras(true) 
获取 上 一 个 接收 者 所 存 入 的 数据 。 


(.3 建立 与 访问 者 相互 通信 的 本 地 Service 


当 程序 通过 startService() 启 动 服务 和 通过 stopService() 关 闭 服 务 时 ,Service 与 访问 
者 之 间 基 本 不 存在 太 多 的 关联 ,因此 Service 和 访问 者 之 间 无 法 进行 通信 或 数据 交换 。 因 


第 7 章 通过 计时 器 详细 介绍 Service 及 BroadcastReceiver 199 


此 ,Android 提供 了 另 一 种 方式 即使 用 bindService() 和 unbindService() 的 方法 来 启动 和 关 
闭 服 务 , 以 使 Service 和 访问 者 之 间 可 以 进行 方法 调用 或 数据 交换 。 

Context 的 bindService ( ) 方 法 的 完整 方法 签名 为 bindService (Intent service, 
ServiceConnection conn, int flag) ,该 方法 的 三 个 参数 含义 如 下 : 

如 service 一 一 该 参数 通过 Intent 指定 要 启动 的 Service, 

a conn —- iX 2 S RE — ^ ServiceConnection 对 象 ,该 对 象 用 于 监听 访问 者 与 Service 

之 间 的 连接 情况 。 当 访问 者 与 Service 之 间 连 接 成 功 时 ,将 回调 ServiceConnection 对 
象 的 onServiceConnected (ComponentName name. IBinder service) 方 法 ; 当 访 问 者 与 
Service 之 间断 开 连 接 时 ,将 回调 该 ServiceConnection 对 象 的 onServiceDisconnected 
(ComponentName name) 方 法 。 
名 flag 一 一 指定 绑 定 时 是 否 自动 创建 Service( 如 果 Service 还 未 创建 )。 该 参数 可 指定 
为 0( 不 自动 创建 ) 或 BIND_AUTO_CREATE( 自 动 创 建 )。 
注意 ,ServiceConnection 对 象 的 onServiceConnected 方法 中 有 一 个 IBinder 对 象 , 该 对 
象 即 可 实现 与 被 绑 定 Service 之 间 的 通信 。 

当 开 发 Service 类 时 ,该 Service 类 必须 提供 一 个 IBinder onBind(Intent intent) 方 法 ,在 
绑 定 本 地 Service 的 情况 下 ,onBind(Intent intent) 方 法 所 返回 的 IBinder 对 象 将 会 传 给 
ServiceConnection 对 象 中 onServiceConnected(ComponentName name, IBinder service) Jf 
法 的 service 参数 ,这 样 访问 者 就 可 通过 该 IBinder 对 象 与 Service 进行 通信 。 

实际 开发 中 通常 会 采用 继承 Binder CIBinder 的 实现 类 ) 的 方式 实现 自己 的 IBinder 
对 象 。 

下 面 的 程序 示范 了 如 何在 Activity 中 绑 定 本 地 Service, 并 获取 Service 的 运行 状态 。 
该 程序 的 Service 类 需要 真正 实现 onBind() 方 法 ,并 让 该 方法 返回 一 个 有 效 的 IBinder 对 
象 ,该 Service 类 的 代码 如 下 : 





import android. app. Service; 


import android. content. Intent; 
import android. os. Binder; 
import android. os. IBinder; 


public class BindService extends Service { 
private int count; 
Private boolean quit; 
// 定 义 onBinder 方法 所 返回 的 对 象 
private MyBinder binder = new MyBinder(); 


// 通 过 继承 Binder 来 实现 IBinder 类 
public class MyBinder extends Binder { 
public int getCount() ( 
// 获 取 Service 的 运行 状态 : count 


return count; 
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// 必 须 实现 的 方法 

@Override 

public IBinder onBind( Intent intent) { 
System. out. println("Service is Binded"); 
//i& |f] IBinder 对 象 
return binder; 


) 


//Service 被 创建 时 回调 该 方法 。 
@Override 
public void onCreate() { 
super. onCreate() ; 
System. out. println("Service is Created"); 
// 启 动 一 条 线程 动态 地 修改 count 状态 值 
new Thread() ( 
(QOverride 
public void run() ( 
while (!quit) ( 
try { 
Thread. sleep(1000); 
} catch (InterruptedException e) { 
} 


Count++; 
} 
} 
}.start(); 
//Service 被 断 开 连 接 时 回调 该 方法 
@Override 


public boolean onUnbind( Intent intent) { 
System. out. println("Service is Unbinded"); 
return true; 


) 
//Service 被 关闭 之 前 回调 
(QOverride 


public void onDestroy() { 
super. onDestroy() ; 
this.quit - true; 
System. out. println("Service is Destroyed"); 


(BOverride 

public void onRebind(Intent intent) { 
super. onRebind( intent); 
this.quit = true; 
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System. out. println("Service is ReBinded"); 


) 


上 面 的 Service 类 实现 了 onBind() 方 法 ,该 方法 返回 一 个 可 访问 该 Service 状态 数据 
Ccount 值 ) 的 IBinder 对 象 ,该 对 象 将 被 传 给 该 Service 的 访问 者 。 

接 下 来 定义 一 个 Activity 来 绑 定 该 Service, 并 在 该 Activity 中 通过 MyBinder 对 象 访 
If] Service 的 内 部 状态 。 该 Activity 的 界面 上 包含 三 个 按钮 : 第 一 个 按钮 用 于 绑 定 Service. 
第 二 个 按钮 用 于 解除 绑 定 ,第 三 个 按钮 用 于 获取 Service 的 运行 状态 。 该 Activity 的 代码 
WTF: 


import android. app. Activity; 

import android. app. Service; 

import android. content. ComponentName; 
import android. content. Intent; 

import android. content. ServiceConnection; 
import android. os. Bundle; 

import android. os. IBinder; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. Button; 

import android. widget. Toast; 


public class MainActivity extends Activity ( 
Button bind, unbind, getServiceStatus; 
// 保 持 所 启动 的 Service 的 IBinder 对 象 
BindService. MyBinder binder; 
// 定 义 一 个 ServiceConnection 对 象 
private ServiceConnection conn = new ServiceConnection() ( 
// 当 该 Activity 5j Service 连接 成 功 时 回调 该 方法 
@Override 
public void onServiceConnected( ComponentName name, IBinder service) { 
System. out. println(" -— Service Connected -- "); 
// 获 取 Service 的 onBind 方法 所 返回 的 MyBinder 对 象 


binder = (BindService.MyBinder) service; 


// 当 该 Activity 5 Service 断 开 连 接 时 回调 该 方法 

@Override 

public void onServiceDisconnected(ComponentName name) { 
System. out. println(" —- Service Disconnected -- "); 


) 


(QOverride 

public void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. main); 
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// 获 取 程 序 界面 中 的 start, stop.getServiceStatus 按钮 
bind = (Button) findViewById(R. id. bind); 
unbind = (Button) findViewById(R. id. unbind); 
getServiceStatus - (Button) findViewById(R. id. getServiceStatus); 
// 创 建 启动 Service 的 Intent 
final Intent intent = new Intent(); 
// 3 Intent 设置 Action 属性 
intent. setAction( "org. crazyit. service. BIND SERVICE"); 
bind. setOnClickListener(new OnClickListener() { 
@Override 
public void onClick(View source) { 
// 绑 定 指 定 Serivce 
bindService(intent, conn, Service.BIND AUTO CREATE); 
) 
Di 
unbind. setOnClickListener(new OnClickListener() ( 
@Override 
public void onClick(View source) { 
// 解 除 绑 定 Serivce 
unbindService(conn); 
} 
D; 
getServiceStatus. setOnClickListener(new OnClickListener() ( 
(2 Override 
public void onClick(View source) ( 
// 获 取 、 并 显示 Service 的 count 值 
Toast. makeText (MainActivity. this, "Serivce 的 count 值 为 : " + binder. 
getCount(), 4000). show(); 
} 
n»; 


) 


上 面 的 程序 用 于 在 该 Activity 与 Service 连接 成 功 时 获取 Service 的 onBind() 方 法 所 
返回 的 MyBinder 对 象 并 通过 MyBinder 对 象 来 访问 Service 的 运行 状态 。 

运行 该 程序 , 单 击 程序 界面 中 的 “ 绑 定 Service" fi £L. BI n] fi $8] DDMS 的 LogCat 有 如 
图 7.3 所 示 的 输出 。 


1 09-28 15:32:55.138 921 321 Org.crazyit.service — System.out Service is Created 
I 09-28 15:32:55.178 — 921 921 Org.crazyit.service — System.out Service is Binded 
I 09-28 15:32:55.188 — 921 321 org.crazyit.service ^ System.out --Service Connected-- 


图 7.3 绑 定 Service 


单 击 界面 上 的 “获取 Service 状态 ”按钮 可 看 到 如 图 7. 4 所 示 效 果 。 
单 击 界面 上 的 “解除 绑 定 按钮 , 即 可 在 DDMS 的 LogCat 中 看 到 如 图 7.5 所 示 的 
输出 。 
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绑 定 Service M f 获取 Service 状 态 





图 7.4 获取 Service 状态 





图 7.5 解除 绑 定 Service 


7.4 Service 的 生命 周期 


在 运行 7. 3 节 所 附带 的 例子 时 ,通过 在 DDMS 面板 上 的 输出 也 大 致 了 解 了 启动 服务 方 
式 为 bindService 以 及 停止 服务 方式 为 unbindService 时 的 生命 周期 形态 ,那么 如 果 程 序 是 
通过 startService 和 stopService 方式 来 启动 和 停止 服务 ,其 生命 周期 又 是 如 何 呢 ? 

为 了 让 读者 有 直观 的 感受 ,我们 对 7. 1 节 所 实现 的 计时 器 服务 类 TimeService 稍 做 修 
改 , 在 Service 类 所 有 的 生命 周期 方法 中 都 打印 出 相应 的 日 志 , 例 如 ,在 TimeService 类 中 的 
onCreateO 方法 中 加 入 Log. i C" TimeService". "- -- onCreate- -- - --") RE íT. TE 
TimeService 生命 周期 期 间 将 会 自动 回调 这 些 方法 并 打印 出 相应 日 志 。 

接着 ,启动 计时 器 应 用 , 单 击 * 开 始 计时 ?按钮 ,这 时 在 DDMS 面板 中 可 以 看 到 如 图 7. 6 
所 示 的 输出 日 志 。 





图 7.6 startService 时 回调 方法 
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然后 , 单 击 程序 界面 中 的 “停止 计时 ”按钮 ,这 时 在 DDMS 面板 中 可 以 看 到 如 图 7.7 所 





















示 + 
示 的 打印 日 志 。 
I 10-01 06:28: 277 277 cn.edu.hstc.count...  TimeService 
I 10-01 :19.946 — 277 27 cn.edu.hstc.count... TimeService 
I 10-01 06:28:19.956 — 277 27 cn.cdu.hstc.count... TimeService 
I 10-01 06:28:22. 277 27] cn.edu.hstc.count... TimeService 
Pn 
stopService 时 回调 方法 


图 7.7 stopService 时 回调 方法 


从 上 面 的 输入 日 志 可 以 了 解 到 ,程序 使 用 startService 启动 服务 以 及 stopService 停止 
服务 时 ,Service 的 生命 周期 为 onCreate() --> onStartCommandO --> onStart() --> Service 
running -之 (如 果 调 用 Context. stopService())onDestroy() --> Service shut down。 

在 这 里 需要 注意 的 是 ,onStart 方法 是 在 Android 2.0 之 前 的 平台 使 用 的 。 在 Android 
2.0 及 其 之 后 , 则 需 重 写 onStartCommand 方法 ,同时 , 旧 的 onStart 方法 不 会 再 被 直接 调 
用 ,而 是 外 部 调用 onStartCommand 方法 ,onStartCommand 方法 会 再 调用 onStart 方法 。 
在 Android 2. 0 之 后 ,推荐 覆盖 onStartCommand 方法 ,而 为 了 向 前 兼容 ,在 onStartCommand 依 
然 会 调用 onStart 方法 。 

当 程 序 使 用 bindService 绑 定 服务 以 及 unbindService 解 绑 服务 时 ,Service 的 生命 周期 
为 onCreate() --> onBind() --> Service running -— (如 果 调 用 Context. unbindService()) 
onUnbind() --> onDestroy() --> Service stop. 

在 此 ,通过 如 图 7.8 所 示 的 流程 图 来 描述 上 面 两 种 Service 生命 周期 形态 。 


Se s 
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bindService() 
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图 7.8 两 种 Service 生命 周期 过 程 
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在 如 图 7. 8 所 示 的 流程 图 中 ,左边 为 startService 启动 Service 时 所 经 过 的 生命 周期 , 右 
边 为 bindService 绑 定 Service 时 所 经 过 的 生命 周期 。 


G. 接收 系统 广播 消息 


现在 ,假定 一 个 场景 , 当 用 户 的 手机 电量 发 生 改变 或 者 电量 过 低 时 ,会 有 一 个 消息 提示 
用 户 。 想 要 做 到 这 一 点 ,就 需要 利用 Android 系统 对 外 发 送 的 电池 电量 广播 。 接 下 来 ,通过 
一 个 手机 电池 电量 监听 器 的 应 用 来 了 解 Android 如 何 处 理 系统 广播 消息 。 

开发 该 手机 电量 监听 程序 的 核心 代码 是 开发 一 个 广播 接收 者 ,该 广播 接收 者 监听 系统 
发 送 的 手机 电量 广播 , 当 电 量 发 生变 化 时 ,提示 用 户 。 核 心 代码 如 下 : 


package cn. edu. hstc. batteryreceiverdemo. broadcast; 


import android. content. BroadcastReceiver; 
import android. content. Context; 

import android. content. Intent; 

import android. os. Bundle; 

import android. widget. Toast; 


public class BatteryReceiver extends BroadcastReceiver ( 
@Override 
public void onReceive(Context context, Intent intent) { 

if (Intent. ACTION BATTERY OKAY.equals(intent.getAction())) { 
Toast.makeText(context, "电量 已 恢复 , nT DL f Hj! ", Toast. LENGTH LONG). show() ; 

) 

if (Intent. ACTION BATTERY LOW. equals(intent.getAction())) ( 
Toast.makeText(context, "电量 过 低 , 请 尽快 充电 !",，Toast. LENGTH_LONG). show() ; 

} 

if (Intent. ACTION BATTERY CHANGED. equals( intent. getAction())) ( 
Bundle bundle - intent.getExtras(); 
// 获 取 当 前 电量 
int current = bundle.getInt("level"); 
// 获 取 总 电量 
int total = bundle.getInt("scale"); 
StringBuffer sb = new StringBuffer(); 
sb. append(" 当 前 电量 为 : " + current * 100 / total + "$" +" "); 
// 如 果 当 前 电量 小 于 总 电量 的 15 & 
if (current * 1.0 / total < 0.15) ( 

sb.append(" 电 量 过 低 , ES Be Ei 1"); 
) else { 
sb.append(" 电 量 足够 ,请 放心 使 用 ! ") ; 

) 
Toast.makeText(context, sb.toString(), Toast.LENGTH LONG).show(); 


} 


代码 文件 : codes\04\4.1\BatteryReceiverDemo\cn\edu\hstc\batteryreceiverdemo\ 
broadcast\BatteryReceiver. java 
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上 面 的 程序 实现 通过 接收 系统 广播 消息 获取 手机 电池 总 电量 、 当 前 电量 , 当 电 量 发 生变 
化 时 ,如 果 当 前 电量 与 总 电量 百分比 小 于 15%%, 则 提示 用 户 “ 电 量 过 低 , 请 尽快 充电 !”, 和 否则 
提示 “电量 足够 ,请 放心 使 用 !”。 当 电量 从 不 足 状态 恢复 时 ,提示 用 户 “ 电 量 已 恢复 ,可 以 
使 用 !”。 

接着 ,需要 在 全 局 配置 文件 配置 开发 好 的 BoradcastReceiver ,代码 片段 如 下 : 

<?xml version= "1.0" encoding = "utf - 8"?> 

< manifest xmlns:android = "http://schemas. android. com/apk/res/android" 

package = "com. example. batteryreceiverdemo" 


android:versionCode - "1" 
android:versionName = "1.0" > 


« uses - sdk 
android:minSdkVersion - "8" 
android:targetSdkVersion = "8" /> 


<! -- 配置 广播 接收 者 --> 
< application 
android:allowBackup = "true" 
android: icon = "(Zdrawable/ic launcher" 
android: label = "@string/app_name" 
android: theme = "@style/AppTheme" > 
< receiver android: name = " cn. edu. hstc. batteryreceiverdemo. broadcast. 
BatteryReceiver" » 
< intent - filter > 
<action android:name = "android. intent. action. BATTERY_CHANGED" /> 
<action android:name = "android. intent. action. BATTERY_OKAY" /> 
< action android:name = "android. intent. action. BATTERY LOW" /> 
«/intent - filter» 
</receiver > 


</application> 


</manifest > 


上 面 配置 文件 中 为 BatteryReceiver 配置 了 intent-filter, 该 intent-filter 的 三 个 action 
属性 值 分 别 为 BATTERY_CHANGED( 电 量 发 生 改 变 时 ,系统 对 外 发 送 Intent 的 Action 
为 ACTION_BATTERY_CHANGED 常量 的 广播 )、.BATTERY_OKAY (电量 从 不 足 状 态 
恢复 时 ,系统 对 外 发 送 Intent 的 Action 为 ACTION BATTERY | OKAY 常量 的 广播 )、 
BATTERY_LOW( 电 量 过 低 时 ,系统 对 外 发 送 Intent 的 Action 为 ACTION_BATTERY_ 
LOW 常量 的 广播 ) 。 

从 上 面 小 程序 的 开发 介绍 中 可 以 了 解 到 ,BroadcastReceiver 除了 用 于 接收 用 户 自 定义 
的 广播 之 外 ,还 用 于 接收 系统 的 广播 .这 也 是 其 重要 的 用 途 之 一 。Android 的 大 量 系统 事件 
都 会 对 外 发 送 标准 广播 。 下 面 是 Android 常见 的 广播 Action 常量 : 

4 ACTION. TIME CHANGED — A At itj [i] t IAE 

名 ACTION_DATE_CHANGED 一 一 系统 日 期 被 改变 。 

名 ACTION_TIMEZONE_CHANGED 一 一 系统 时 区 被 改变 。 


第 7 章 ”通过 计时 器 详细 介绍 Service 及 BroadcastReceiver 207 


名 ACTION_BOOT_COMPLETED 一 一 系统 启动 完成 。 

名 ACTION_BATTERY_CHANGED 一 一 电池 电量 改变 。 

名 ACTION_BATTERY_ LOW 一 一 电池 电量 过 低 。 

4 ACTION POWER. CONNECTED 一 一 系统 连接 电源 。 

4 ACTION POWER. DISCONNECTED 一 一 系统 与 电源 断 开 。 


0.6 本 章 小 结 


本 章 通过 实现 计时 器 介绍 了 开发 Service 以 及 BoradcastReceiver 的 流程 ,读者 应 将 学 
习 重 点 放 在 创建 和 配置 Service 组 件 以 及 如 何 启动 和 停止 Service E; 学 习 BoradcastReceiver 
时 ,需要 掌握 创建 .配置 BoradcastReceiver 组 件 以 及 如 何在 程序 中 发 送 Broadcast. 
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当 想 要 设置 应 用 程序 的 某 些 参数 、 保 存 应 用 退出 时 的 运行 状态 .将 大 量 的 歌曲 放 在 手机 
中 时 ,这 些 数据 都 需要 存储 在 外 部 存储 器 上 ,如 SD 卡 (SD Card) ,这 样 在 系统 关机 之 后 数据 
并 不 会 丢失 。 以 上 这 些 都 将 涉及 Android 系统 一 些 专门 操作 输入 输出 的 APL 

当然 ,如 果 仅仅 只 是 想 将 少量 的 数据 保存 起 来 ,那么 使 用 普通 文件 就 可 以 了 ; 但 是 如 果 
应 用 程序 有 大 量 数据 需要 存储 和 访问 ,就 需要 借助 Android 系统 内 置 的 一 个 轻 量 级 数据 库 
SQLite T. SQLite 内 置 于 Android 中 ,没有 后 台 进程 ,一 个 数据 库 就 对 应 一 个 文件 ,做 到 
真正 的 轻 量 级 。 本 章 将 会 详细 介绍 如 何 利用 Android 提供 的 大 量 的 操作 SQLite 数据 库 的 
API 来 使 用 SQLite 数据 库 。 


8. 1 使 用 SharedPreferences 


应 用 程序 有 时 需要 保存 的 数据 数量 非常 少 并 且 数 据 格式 非常 简单 ,如 是 否 打 开 音 效 、 
QQ 软件 打开 夜间 模式 . 收 到 微 信 消息 时 是 否 打开 振动 效果 、 记 住 登录 账号 和 密码 等 操作 时 
存储 的 配置 信息 。 这 些 都 是 一 些 普通 的 字符 串 或 者 键 值 对 (key-value), 对 于 这 种 数据 ， 
Android 使 用 SharedPreferences 进行 保存 。 


8.1.1 通过 密码 记 住 功能 学 习 使 用 SharedPreferences 


本 节 将 实现 一 个 带 有 密码 记 住 功能 的 登录 界面 。 该 登录 界面 比较 简单 ,从 上 至 下 放置 
了 账号 输入 框 、 密 码 输入 框 . 记 住 密码 的 多 选 按钮 .登录 按钮 。XML 代码 如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 
< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:background = " # £1f0f0" 
android:orientation = "vertical" > 


< TableLayout 
android:layout width = "fill parent" 
android:layout height - "wrap content" 
android:paddingTop = "30dp" 
android:stretchColumns = "2" > 


< TableRow > 


< TextView 


android: 
android: 


< TextView 


android: 


android 
android 


« EditText 


android: 
android: 
android: 
android: 
android: 


< TextView 


android: 
android: 


</TableRow > 


< TextView 
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layout width= "10dp" 
layout height = "1dp" /> 





id- "(A + id/txt_account" 


:layout width= "wrap_content"” 
:layout height = "wrap content" 
android: 


text = "账号 : " /> 


id- "(à + id/edit account" 

layout width- "wrap content" 

layout height = "wrap content" 
background = "(à drawable/shurukuang" 
paddingLeft = "5dp" /» 


layout width- "10dp" 
layout height = "1dp" /> 


android:layout width- "fill parent" 
android:layout height = "10dp" /> 


< TableRow > 


< TextView 
android: 
android: 


layout width = "10dp" 
layout height = "idp" /> 


id:id- "@ + id/txt pwd" 


id:layout width- "wrap content" 


id:layout height = "wrap content" 
id:text = "密码 : " /> 





androi 


< TextView 


android: 
android: 








:id= "@ + id/edit pud" 

id: layout_width = "wrap_content" 
id:layout height = "wrap content" 

id: background = "(à drawable/shurukuang" 
id: password = "true" 

id:paddingLeft = "5dp" /> 


layout_width = "10dp" 
layout_height = "1dp" /> 
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</TableRow > 
«/TableLayout > 


<LinearLayout 
android:layout width= "fill parent" 
android:layout height = "wrap content" 
android:gravity = "center horizontal" 
android:orientation = "horizontal" > 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = " x 记 住 账号 密码 ,方便 下 次 登录 " 
android: textColor = "@android:color/black" /> 


< CheckBox 

android:id- "(à + id/cbx remember" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
style = "(à style/CustomCheckboxTheme" 
android:layout marginLeft = "l0dp" 
android:checked - "false" /» 

«/LinearLayout > 


« Button 
android:id- "(9 + id/btn login" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:background = "(2drawable/style button" 
android:layout gravity = "center horizontal" 
android:layout marginLeft - "10dp" 
android:layout marginRight = "10dp" 
android:text = "登录 " /> 


</LinearLayout > 


当 用 户 单 击 “登录 ?按钮 时 ,程序 将 会 自动 识别 用 户 是 否 选 中 了 记 住 密码 功能 ,如 有 , 则 
将 账号 和 密码 写 和 人 SharedPreferences 中 并 跳 转 到 欢迎 页 面 。 在 登录 界面 所 对 应 的 主 程序 
LoginActivity 类 中 实现 了 该 核心 功能 。 


package net. edu. hstc. rememberpwd. activity; 


import java. util. Timer; 
import java. util. TimerTask; 


import android. app. Activity; 

import android. app. AlertDialog; 

import android. content. Context; 

import android. content.DialogInterface; 

import android. content. DialogInterface. OnCancelListener; 
import android. content. Intent; 


358€ ”Android 的 数据 存储 以 及 文件 读 写 


import android. content. SharedPreferences; 

import android. content.SharedPreferences. Editor; 
import android. os. Bundle; 

import android. view. View; 


import android. widget. Button; 

import android. widget. CheckBox; 

import android. widget. CompoundButton; 

import android. widget. CompoundButton. OnCheckedChangeListener; 
import android. widget. EditText; 

import android. widget. LinearLayout; 

import android. widget. TextView; 


import android. widget. Toast; 


public class LoginActivity extends Activity ( 
private EditText accountEdit, pwdEdit; 
private CheckBox rememberCbx; 
private Button loginBtn; 


// 声 


明 SharedPreferences 


private SharedPreferences sp; 


// 声 


明 SharedPreferences. Editor 


private Editor editor; 


private AlertDialog prompt; 


private Timer timer; 


private boolean flag = true; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


super. onCreate(savedInstanceState); 
setContentView(R.layout.activity login); 
// 初 始 化 组 件 


initView(); 


// 获 得 SharedPreferences 实例 对 象 并 指定 该 SharedPreferences 数据 能 被 其 他 应 用 程序 


读 , 但 不 能 写 


ent 


[sx 


Sp 7 this.getSharedPreferences("userInfo", Context.MODE WORLD READABLE); 


editor - sp.edit(); 
timer = new Timer(); 


// 当 获取 SharedPreferences 中 remember 值 为 true 时 ,将 选项 按钮 置 为 选中 状态 


// 将 account 值 跟 pwd 值 分 别 设 在 账号 输入 框 跟 密码 输入 框 中 
if (sp. getBoolean("remember", false)) { 


if (!sp.getString("account", "").equals("") && ! sp. getString("pwd", "").equals 


rememberCbx. setChecked(true); 
accountEdit. setText(sp. getString("account", "")); 
pwdEdit. setText(sp. getString("pwd", "")); 


* 通过 id 加载 ,初始 化 登录 界面 中 各 个 组 件 


x*/ 
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private void initView() { 
accountEdit = (EditText) findViewById(R. id. edit account); 
pwdEdit = (EditText) findViewById(R. id.edit pwd); 
rememberCbx = (CheckBox) findViewById(R. id.cbx remember); 
loginBtn = (Button) findViewById(R. id.btn login); 


// 为 多 选 按钮 设置 监听 器 
rememberCbx. setOnCheckedChangeListener(new OnCheckedChangeListener() { 
(QOverride 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (rememberCbx. isChecked()) ( 
editor.putBoolean("remember", true).commit(); 
} else if (!rememberCbx. isChecked()) ( 
editor.putBoolean("remember", false); 
editor. remove("account"); 
editor. remove("pwd" ) ; 
editor.commit(); 


n; 


loginBtn. setOnClickListener(new View.OnClickListener() ( 
(2 0Override 
public void onClick(View v) ( 
String accountStr = accountEdit.getText().toString(); 
String pwdStr = pwdEdit.getText().toString(); 
if (accountStr. equals("hstc") && pwdStr. equals("123456")) ( 
if (rememberCbx.isChecked()) ( // 当 用 户 记 住 密码 时 
editor. putString("account", accountStr); 
editor. putString("pwd", pwdStr); 
editor. commit( ); 
) 
prompt = prompt(LoginActivity.this, "登录 成 功 ,正在 跳 转 .…"); 
prompt. setOnCancelListener(new OnCancelListener() ( 
@Override 
public void onCancel(DialogInterface dialog) { 
if (prompt. isShowing()) { 
prompt.dismiss(); 


ni 
timer. schedule(new TimerTask() ( 
(GOverride 
public void run() ( 
if (flag) { 
if (prompt. isShowing()) ( 
prompt. dismiss(); 
) 
flag 7 false; 
timer.cancel(); 
timer. purge(); 
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timer = null; 
Intent intent = new Intent(LoginActivity. this, 
MainActivity. class); 
LoginActivity. this. startActivity( intent); 
LoginActivity. this. finish(); 
} 
} 
}, 3000, 5000); // 弹 窗 提示 3 秒 
} else if (accountStr. equals("") || pwdStr. equals("")) ( 
Toast. makeText (LoginActivity. this, "账号 或 密码 不 能 为 空 !"，Toast. 
LENGTH_LONG). show( ) ; 
} eise ( 
Toast. makeText(LoginActivity. this, "账号 或 密码 错误 , 请 重新 登录 !"， 
Toast.LENGTH LONG).show(); 
) 
) 
ni 
) 


/ xx 
* 提示 对 话 框 
*/ 
private AlertDialog prompt(Activity context, String content) { 
AlertDialog. Builder builder = new AlertDialog. Builder(context); 
LinearLayout layout = (LinearLayout) context.getLayoutInflater(). inflate(R. layout. 
prompt, null); 
((TextView) layout. findViewById(R. id. message) ) . setText(content); 
builder. setView( layout); 
AlertDialog dialog = builder. show(); 
dialog. setCanceledOnTouchOutside( false); 
return dialog; 


) 


上 面 程序 实现 当 用 户 选 择 记 住 密码 登录 时 ,将 会 把 账号 与 对 应 的 密码 一 起 写 入 
SharedPreferences 中 ,在 程序 退出 后 再 次 被 打开 时 ,在 登录 界面 中 将 会 自动 把 存放 在 
SharedPreferences 中 的 账号 与 密码 获取 出 来 并 显示 在 相应 的 文本 输入 框 中 。 程 序 中 所 对 
应 的 欢迎 界面 MainActivity 类 比较 简单 .此 处 不 再 袭 述 。 

将 程序 部 署 在 Android 模拟 器 中 ,出 现 了 如 图 8. 1 所 示 的 登录 界面 ,在 “账号 "输入 框 中 
输入 hste 并 在 “密码 ”输入 框 中 输入 123456 ,选中 记 住 密码 功能 ,然后 单 击 “ 登 录 ” 按 钮 ， 
图 8. 2 是 当 用 户 记 住 密码 登录 后 重启 应 用 时 的 登录 界面 效果 图 ,图 8. 3 为 用 户 正 在 登录 中 
界面 ,3 秒 钟 后 跳 到 如 图 S. 4 所 示 的 欢迎 页 面 , 按 下 硬 键 盘 上 的 返回 键 ,退出 程序 ,重新 启动 
程序 ,将 会 看 到 此 时 的 登录 页 面 中 的 账号 输入 框 以 及 密码 输入 框 已 经 自动 有 了 值 。 

本 应 用 为 了 记 住 用 户 密码 ,使 用 了 SharedPreferences。SharedPreferences 实现 
Android 平台 的 轻 量 级 存储 , 主要 用 来 保存 一 些 常 用 的 配置 参数 ,如 保存 了 用 户 的 登录 信 
息 。SharedPreferences 采用 XML 文件 存放 数据 ,文件 存放 在 /data/data/< packagename >/ 
shared_prefs 目录 下 。 
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从 本 应 用 的 LoginActivity 类 中 的 源 代码 可 以 看 出 ,程序 并 没有 直接 创建 SharedPreferences 
实例 ,而 是 通过 Context 提供 的 getSharedPreferences(String name, int mode) 方 法 来 获取 
SharedPreferences 实例 ,如 代码 行 getSharedPreferences ( " userInfo" .. Context. MODE _ 
WORLD_READABLE)。 实 际 上 ,该 方法 的 第 二 个 参数 通常 会 指定 以 下 三 个 值 : 

æ Context. MODE_PRIVATE 一 一 指定 该 SharedPreferences 数据 只 能 被 本 应 用 程序 


所 读 、 写 。 

æ Context. MODE_WORLD_READABLE 一 一 指定 该 SharedPreferences 数据 能 被 其 
他 应 用 程序 读 ,但 不 能 写 。 

z Context. MODE WORLD WRITEABLE — 1&8 E i SharedPreferences 数据 能 被 其 
他 应 用 程序 所 读 、 写 。 


SharedPreferences 是 以 键 值 对 (key-value) 的 形式 保存 数据 的 , 因此 是 通过 
SharedPreferences 本 身 的 getXxx(String key. xxx defValue) 方 法 来 获取 相关 的 数值 的 。 
如 程序 中 代码 行 accountEdit. setText (sp. getString ("account",，""))。 实 际 上 ， 
SharedPreferences 提供 了 如 下 常用 方法 来 访问 应 用 程序 的 Preferences 数据 。 

4 boolean contains(String key); 判断 SharedPreferences 是 否 包含 特定 key 的 数据 。 

ar abstract Map < String. ? > getAll(): 获取 SharedPreferences 数据 里 全 部 的 键 值 对 。 

Zr xxx getXxx(String key, xxx defValue) : 获取 SharedPreferences 数据 里 指定 key 对 
应 的 value。 如 果 该 key 不 存在 , 则 返回 默认 值 defValue。 其 中 xxx 可 以 是 boolean、 
float int, long, String 等 各 种 基本 数据 类 型 。 

由 于 SharedPreferences 接口 本 身 并 没有 写 入 数据 的 操作 能 力 , 故 需要 通过 
SharedPreferences 的 内 部 接口 Editor 提供 的 方法 来 向 SharedPreferences 中 写 入 数据 。 如 
代码 行 editor = sp. edit() ,SharedPreferences 调用 本 身 的 edit() 方 法 即 可 获取 它 所 对 应 的 
Editor 对 象 ,进而 写 和 人 数据。SharedPreferences. Editor 提供 了 如 下 写 操作 数据 方法 : 

A SharedPreferences, Editor clear() 一 一 清空 SharedPreferences 中 的 所 有 数据 。 

 SharedPreferences. Editor putXxx(String key. xxx value) 一 一 向 SharedPreferences 中 存 
入 指定 key 对 应 的 数据 。 其 中 xxx 可 以 是 boolean, float, int, long, String 等 各 种 基 
本 数据 类 型 。 

 SharedPreferences. Editor remove (String key) 一 一 删除 SharedPreferences 中 指定 
key 所 对 应 的 数据 项 。 

4 boolean commit() 一 一 操作 前 面 的 所 有 写 操作 方法 的 最 后 都 需要 调用 该 方法 提交 。 

如 LoginAction 类 中 为 多 选 按 钮 设置 监听 器 的 代码 片段 中 , 当 用 户 反选 该 多 选 按 钮 时 ， 
向 SharedPreferences. Editor 的 对 象 editor 中 存放 一 个 值 为 false 的 boolean 类 型 数据 ,并 
将 调用 removeCString key) 方 法 删除 掉 SharedPreferences 数据 中 的 account, pwd 的 值 ,最 
后 调用 commit() 方 法 提交 所 有 操作 。 代 码 片 段 如 下 : 

// 为 多 选 按钮 设置 监听 器 

rememberCbx. setOnCheckedChangeListener(new OnCheckedChangeListener() { 

@Override 
public void onCheckedChanged( CompoundButton buttonView, boolean isChecked) { 


if (rememberCbx. isChecked()) ( 
editor.putBoolean("remember", true).commit(); 
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) else if (!rememberCbx. isChecked()) ( 
editor.putBoolean("remember", false); 
editor.remove("account"); 
editor. remove("pwd"); 
editor.commit(); 


) 
n; 


8.1.2 SharedPreferences 的 存储 位 置 和 格式 


运行 8.1.1 节 中 的 记 住 密码 功能 的 应 用 程序 ,选中 记 住 密码 选项 按钮 并 单 击 “登录 ” 按 
钮 ,此 时 打开 DDMS 面板 的 File Explorer, 然 后 展开 文件 浏览 树 ,可 以 看 到 如 图 8. 5 所 示 的 





窗口 。 

b © com.android.providers.downloads 2015-09-07 1658 drwxr-x--x 
b © com.android.providers.drm 2015-09-07 1657 drwxr-x--x 
b © com.android.providers.media 2015-09-07 16:58 drwxr-x--x 
b © com.android.providers.setüngs 2015-09-07 16:57 drwxr-x--x 
» £» comandroid.providers.subscribedfeeds 2015.00.07. 1657 drwxr-x--x 
b @ com.android.providers.telephony 2015-09-07 16:58 drwxrx-x 
» © com.android.providers.userdictionary 2015-09-07 16:57 dnwxr-x--x 
b (& com.android.quicksearchbcx 2015-09-07 16:58 drwxr-x--x 
b BE com.android.sdksetup 2015-09-07 1657 drwxr-x--x 
b @ com.android.server.ypn 2015-09-07 1657 drwxr-x--x 
» Be com.android.settings 2015-09-13 0602 drwxr-x--x 
b © com.android.soundrecorder 2015-09-07 1657 drwxr-x--x 
» © com.android.spare parts 2015-09-07 1657 drwxr-x--x 
b BE com.android.speechrecorder 2015-09-07 16:57 drwxr-x--x 
b © com.android.term 2015-09-07 1657 drwxr-x--x 
» £» com.android.wallpaper.livepicker 2015-09-07 1657 drwxr-x--x 
b [5 com.svoxpico 2015-09-07 1657 drwxr-x--x 
» © jp.co.omronsoft.openwnn 2015-09-10 1521 drwxr-x--x 
4 @ netedu.hstc.rememberpwd activity 2015-10-17 0747 drwxr-x-x 
» © lib 2015-10-15 1423 drwxr-xr-x 

4 £5 shared prefs 2015-10-17 1056 __drwxrwx--x 
B userinfoxmi 183 2015-10-17 10:56 -rww 





图 8.5 SharedPreferences 数据 文件 存储 路 径 


在 密码 记 住 功 能 的 程序 代码 中 , 在 LoginActivity 类 中 有 代码 行 sp = this. 
getSharedPreferences("userInfo", Context. MODE_WORLD_READABLE) ,该 行 代 码 实 
际 上 已 经 实现 在 /data/data/< package name »/shared prefs 目录 下 建立 了 一 个 名 为 
userInfo. xml 的 文件 ,该 文件 用 于 保存 该 应 用 的 SharedPreferences 数据 。 通 过 其 文件 名 后 
级 ,可 以 想到 ,SharedPreferences 数据 是 以 XML 格式 写 入 文件 的 。 

通过 File Explorer 面板 中 的 导出 文件 按钮 将 userInfo. xml 文件 导出 到 电脑 桌面 ,通过 
Notepad 十 十 文档 阅读 器 打开 该 文件 ,可 以 看 到 以 下 内 容 : 


X?xml version='1.0' enccdinge'utf-8' standalone='yes' 3» 
<map> 

«string name="account">hstc</string> 

<boolean name="remember" value="true" /> 

<string name="pwd">123456</string> 

</map> 
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可 以 看 出 ,该 文件 中 account 所 对 应 的 值 正 是 8. 1. 1 节 应 用 中 所 对 应 的 登录 账号 ， 
remember 所 对 应 的 值 正 是 密码 的 值 ,因此 ,上 面 文件 保存 了 用 户 账号 与 密码 信息 以 及 是 否 
记 住 密码 的 标识 。 

从 文件 内 容 可 以 看 出 ,SharedPreferences 数据 文件 的 XML 根 元 素 是 < map/>, 该 元 素 
包含 的 每 个 子 元 素 正 代表 了 每 个 保存 到 文件 中 的 键 值 对 。 根 据 保 存 的 基本 数据 类 型 ,这 些 
子 元 素 可 以 是 < Boolean/> .< float/> .< int/>、 < long/>、< String/> 等 等 。 

根据 代码 , 当 用 户 反选 了 记 住 密码 功能 的 选项 按钮 ,将 会 删除 掉 SharedPreferences 数 
据 中 key 为 account 和 pwd 的 键 值 对 ,此 时 再 次 将 File Explorer 面板 中 的 userInfo. xml X 
件 导出 到 电脑 桌面 并 打开 ,可 以 看 到 如 下 内 容 : 





*?xml versicn-'1.0' encoding-'utf-8' standalone-'yes' P> 
|«map» 

4boolean name-"remember" value="false" /> 

«/map» 


通过 以 上 的 介绍 ,不 难 发 现 ,SharedPreferences 数据 总 是 保存 在 /data/data/< package 
name >/shared_prefs 目录 下 并 且 以 XML 格式 保存 。 


6.2 文件 (File) 存 储 


前 面 介绍 的 SharedPreferences 存储 方式 非常 简单 方便 ,但 其 只 适合 存储 比较 简单 的 数 
据 , 如 果 需 要 存储 更 多 的 数据 ,可 行 选择 的 方式 有 好 几 种 ,这 里 要 给 读者 介绍 的 是 文件 存储 
的 方式 。 


8.2.1 文件 的 保存 与 读 取 


与 传统 的 Java IO 访问 磁盘 文件 类 似 , Android 同样 提供 了 自己 的 文件 操作 的 API 供 
用 户 来 访问 手机 存储 器 上 的 文件 。 

下 面 通过 一 个 简易 型 备忘录 来 介绍 文件 的 保存 和 读 取 。 应 用 启动 界面 放置 一 个 文本 输 
入 框 以 及 一 个 按钮 ,在 文本 输入 框 中 输入 要 记录 的 文字 后 单 击 按钮 ,将 会 把 文本 输入 框 中 的 
文字 保存 到 指定 的 文件 中 并 跳 转 到 查看 备忘录 页 面 , 在 该 页 面 读 取 指 定 的 文件 内 容 并 展示 
在 页 面 的 输入 框 中 ,该 页 面 同 时 放置 了 两 个 按钮 : 一 个 用 于 清空 备忘录 文件 ,一 个 用 于 退出 
整个 应 用 程序 。 软 件 所 需要 用 到 的 两 个 界面 都 比较 简单 ,此 处 不 再 给 出 源 代码 ,读者 可 以 通 
过 本 书 附带 源码 查看 这 两 个 界面 布局 代码 。 接 下 介绍 的 是 保存 内 容 到 指定 文件 以 及 读 取 指 
定 文件 的 内 容 并 展示 到 页 面 的 核心 程序 代码 。 

保存 内 容 到 指定 文件 的 核心 程序 如 下 : 


package cn. edu. hstc. fileiodemo. activity; 
import java. io. BufferedWriter; 
import java. io. FileOutputStream; 


import java. io. OutputStreamWriter; 


import android. app. Activity; 
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import android. content. Intent; 
import android. os. Bundle; 

import android. view. View; 

import android. view. Window; 

import android. view. WindowManager; 
import android. widget. Button; 
import android. widget. EditText; 


public class InputActivity extends Activity ( 
// 定 义 要 保存 的 文件 名 
final String FILE NAME = "memorandum. txt"; 
private EditText edit; 
private Button button, reset; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
// 下 面 两 句 实现 界面 全 屏 化 
this.getWindow(). setFlags(WindowManager.LayoutParams. FLAG FULLSCREEN, 
WindowManager. LayoutParams.FLAG FULLSCREEN); 
this.requestWindowFeature(Window.FEATURE NO TITLE); 
setContentView(R.layout.activity input); 
initView(); 


private void initView() ( 
edit - (EditText) findViewById(R. id. edit); 
button = (Button) findViewById(R. id. button); 
reset - (Button) findViewById(R. id. reset) ; 
// 为 记录 按钮 绑 定 事件 监听 器 
button. setOnClickListener(new View.OnClickListener() { 
(2 0Override 
public void onClick(View v) ( 
// 将 文本 输入 框 中 的 内 容 保存 到 文件 memorandum. txt 中 
saveDataToFile(FILE NAME, edit.getText().toString()); 
// 实 现 跳 转 到 查看 备忘录 页 面 
Intent intent = new Intent(InputActivity.this, OutputActivity.class); 
startActivity(intent); 


n; 


// 为 重 置 按 钮 添加 事件 监听 器 
reset.setOnClickListener(new View.OnClickListener() ( 
(2 Override 
public void onClick(View v) ( 
edit.setText(""); 


/xx 
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* 向 File 中 保存 数据 
* @param fileName 
* @param data 
x*/ 
private void saveDataToFile(String fileName, String data) { 
FileOutputStream fileOutputStream - null; 
OutputStreamWriter outputStreamWriter - null; 
BufferedWriter bufferedWriter - null; 
try { 
fileOutputStream - openFileOutput(fileName, MODE APPEND); 
// 以 追加 方式 打开 文件 
outputStreamWriter = new OutputStreamWriter(fileOutputStream); 
bufferedWriter = new BufferedWriter(outputStreamWriter); 
bufferedWriter.write(data); 
) catch (Exception e) ( 
e. printStackTrace(); 
) finally ( 
try ( 
if (bufferedWriter != null) ( 
bufferedWriter.close(); 
) 
) catch (Exception e) ( 
e. printStackTrace(); 


代码 文件 : codes\08\8. 2VFileIODemoVcnVeduMhstcVactivityMInputActivity. java 
从 指定 的 文件 中 读 取 内 容 并 显示 在 页 面 中 的 核心 程序 代码 如 下 : 
package cn. edu. hstc. fileiodemo. activity; 


import java. io. BufferedReader; 
import java. io.FileInputStream; 
import java. io. InputStreamReader; 


import android. app. Activity; 

import android. content. Intent; 
import android. os. Bundle; 

import android. view. View; 

import android. view. Window; 

import android. view. WindowManager; 
import android. widget. Button; 
import android. widget. EditText; 
import android. widget. LinearLayout; 


public class OutputActivity extends Activity { 


// 定 义 要 读 取 的 文件 名 
final String FILE NAME = "memorandum. txt"; 
private LinearLayout backlayout; 
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private EditText show; 
private Button clear, exit; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
// 以 下 两 句 实现 页 面 全 屏 化 
this.getWindow().setFlags(WindowManager.LayoutParams.FLAG FULLSCREEN, 
WindowManager.LayoutParams.FLAG FULLSCREEN); 
this.requestWindowFeature(Window.FEATURE NO TITLE); 
setContentView(R. layout. activity output); 
initView(); 


private void initView() { 
backlayout = (LinearLayout) findViewById(R. id. layout back); 
show = (EditText) findViewById(R. id. show); 
clear = (Button) findViewById(R. id. btn clear); 
exit = (Button) findViewById(R. id. btn exit); 
// 将 读 取 的 文件 内 容 显示 在 文本 输入 框 中 
show. setText(getDataFromFile(FILE NAME)); 
backlayout. setOnClickListener(new View.OnClickListener() ( 
@Override 
public void onClick(View v) { 
OutputActivity. this. finish(); 


Di 
Clear. setOnClickListener(new View. OnClickListener() { 
(2 Override 
public void onClick(View v) { 
// 清 空 备忘录 ,可 以 将 文件 内 容 置 为 空 ,也 可 以 直接 将 文件 删 掉 ,这 里 采用 的 是 直 
接 删除 文件 
deleteFile(FILE NAME); 
show. setText(""); 


H; 
exit. setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent( Intent. ACTION MAIN); 
intent. addCategory( Intent. CATEGORY_HOME) ; 
intent. setFlags( Intent. FLAG ACTIVITY CLEAR TOP); 
startActivity( intent); 
android. os. Process. killProcess(android. os. Process. myPid( ) ); 


J 
* 从 File 中 读 取 数 据 
* @param fileName 
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* @return 
*/ 
private String getDataFromFile(String fileName) { 
FileInputStream fileInputStream = null; 
InputStreamReader inputStreamReader = null; 
BufferedReader bufferedReader = null; 
StringBuilder stringBuilder = null; 
String line = null; 
try { 
stringBuilder = new StringBuilder(); 
fileInputStream = openFileInput(fileName); 
inputStreamReader = new InputStreamReader(fileInputStream); 
bufferedReader = new BufferedReader( inputStreamReader); 
while ((line = bufferedReader.readLine()) != null) ( 
stringBuilder. append( line); 
} 
} catch (Exception e) { 
e. printStackTrace(); 
) finally ( 
try { 
if (bufferedReader != null) { 
bufferedReader. close(); 
) 
) catch (Exception e) ( 
e. printStackTrace(); 
) 
) 
if (stringBuilder !- null) ( 
return stringBuilder. toString(); 
) eise ( 
return ""; 


) 


代码 文件 : codesVOB V8. 2VFileIODemoVcnVeduMhstcVactivityVOutputActivity. java 


上 面 两 段 程序 实现 将 用 户 输 入 的 内 容 保 存在 一 个 叫 memorandum. txt 的 备忘录 文件 中 
并 跳 转 到 查看 备忘录 内 容 页 面 , 在 查看 页 面 中 读 取 memorandum. txt 文件 的 内 容 并 展示 在 
页 面 输入 框 中 , 当 用 户 单 击 * 清 空 备忘录 ”按钮 时 ,删除 memorandum. txt 文件 。 将 程序 部 署 
在 Android 模拟 器 上 ,并 按照 上 面 的 操作 步骤 ,效果 如 图 8.6 和 图 8. 7 所 示 。 
此 时 展开 File Explorer 面板 的 文件 浏览 树 ,可 以 看 到 如 图 8. 8 所 示 窗 口 。 
从 图 8. 8 可 以 看 出 ,应 用 程序 的 数据 文件 保存 路 径 是 /data/data/< package name »/ files. 
从 本 应 用 示例 可 以 看 出 ,Android 提供 了 如 下 两 个 方法 来 访问 应 用 程序 的 文件 IO 流 : 
æ FilelnputStream openFileInput(String name) 一 一 打开 应 用 程序 的 数据 文件 夹 下 的 
name 文件 对 应 输入 流 。 
名 FileOutputStream openFileOutput(String name. int mode) 一 一 打开 应 用 程序 的 数 
据 文件 夹 下 的 name 文件 对 应 输出 流 。 
实际 上 ,Android 还 提供 了 如 下 方法 来 访问 应 用 程序 的 数据 文件 夹 或 文件 夹 下 的 文件 : 
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今天 包 饺 子 
清空 备忘录 退出 备忘录 ， 
图 8.6 输入 内 容 并 单 击 “记录 ”按钮 保存 文件 图 8.7 读 取 文件 内 容 并 展示 
4 © data 2015-09-07 16:57 drwxrwx--x 
© app 2015-10-18 1229 drworwx-x 
© app-private 2015-09-07 1656 drwawx--x 
© backup 2015-09-07 1657 drwx------ 
© dalvik-cache 2015-10-18 12:29 drwxwx--x 
4 © data 2015-10-18 0712 drwerwx-x 
© android.tts 2015-09-07 16:57 drwxr-x--x 
4 © cn.edu.hstc.fileiodemo.activity 2015-10-18 07:12 drwxr-x--x 
4 © files 2015-10-18 13:05  drverwx-x 
E memorandum.bxt 15 2015-10-18 13:05 -mw-rw--- 


图 8.8 数据 文件 保存 路 径 


zt getDir(String name. int mode) 在 应 用 程序 的 数据 文件 夹 下 获取 或 创建 name 对 
应 的 子 目录 。 

File getFilesDir() 获取 应 用 程序 的 数据 文件 夹 的 绝对 路 径 。 

gString[ ] fileList() 返回 应 用 程序 的 数据 文件 夹 下 的 全 部 文件 。 

æ deleteFile(String name) 一 一 删除 应 用 程序 的 数据 文件 夹 下 的 指定 文件 。 


8.2.2 文件 的 操作 模式 


在 上 节 介 绍 的 简易 型 备忘录 的 程序 代码 中 有 这 样 一 句 代 码 : fileOutputStream = 
openFileOutput(fileName, MODE_APPEND) ,这 句 代码 的 功能 也 正 是 上 节 所 介绍 的 打开 
应 用 程序 的 数据 文件 夹 下 的 fileName 文件 对 应 的 输出 流 。 该 名 代码 所 对 应 的 方法 的 第 二 
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个 参数 MODE APPEND 指 的 是 应 用 程序 可 以 以 追加 方式 打开 该 文件 。 实 际 上 该 方法 第 
二 个 参数 指定 的 是 打开 文件 的 模式 ,该 模式 可 以 指定 如 下 值 : 

名 MODE_PRIVATE 一 一 设置 文件 只 能 被 当前 程序 读 写 。 

名 MODE_APPEND 一 一 设置 应 用 程序 可 以 向 该 文件 追加 内 容 。 

名 MODE_WORLD_READABLE 一 一 设置 该 文件 可 以 被 其 他 应 用 程序 读 取 。 

名 MODE_WORLD_WRITEABLE 一 一 设置 该 文件 可 以 被 其 他 应 用 程序 读 、 写 。 


8.2.3 通过 图 片 下 载 器 实现 操作 SD 卡 


由 于 设备 内 置 存储 空间 是 有 限 的 ,所 以 , 仅 通过 openFileInput 或 openFileOutput 打开 
应 用 程序 的 数据 文件 夹 里 的 文件 输入 流 、 输 出 流 来 操作 文件 数据 的 存储 是 远 远 不 够 的 ,有 时 
为 了 更 好 地 存 、 取 大 文件 数据 ,应 用 程序 需要 访问 到 设备 的 外 部 存储 器 ,如 SD 卡 ,这 将 大 大 
扩充 Android 设备 的 存储 能 力 。 

本 节 将 通过 一 个 简单 的 图 片 下 载 器 应 用 来 介绍 程序 如 何 将 从 网 络 下 载 的 图 片 保存 在 
SD 卡 上 以 及 从 SD 卡 上 将 存储 的 图 片 显 示 在 页 面 ,以 此 掌握 访问 SD 卡 的 方法 。 

该 图 片 下 载 器 应 用 界面 十 分 简单 ,从 上 至 下 分 别 放 置 了 一 个 文本 输入 框 用 于 显示 图 片 
下 载 地 址 ,一 个 Button 按钮 用 来 单 击 以 便 将 网 络 图 片 下 载 并 保存 在 手机 SD 卡 中 , 另 一 个 
Button 按钮 供用 户 单 击 从 SD 卡 中 获取 下 载 的 图 片 并 显示 在 界面 底部 的 图 像 视图 
ImageView 中 。 

由 于 该 界面 布局 比较 简单 ,故此 处 不 再 给 出 源码 ,读者 可 以 通过 阅读 本 书 所 附带 源码 获 
得 。 接 下 来 重点 学 习 的 是 本 实例 中 需要 用 到 的 操作 SD 卡 的 工具 类 FileUtil 类 的 源码 ,通过 
学 习 该 工具 类 掌握 如 何 访问 Android 设备 的 SD 卡 。 该 工具 类 源码 如 下 : 





package cn. edu. hstc. sdcarddemo. util; 
import java. io. File; 

import java. io. IOException; 

import android. os. Environment; 


public class FileUtil ( 

Jar 

* 判断 是 否 Android 设备 插入 了 SD 卡 并 且 应 用 程序 具有 读 写 SD 卡 的 权限 

* 

py 
public static Boolean isHaveSDCard() ( 
return Environment.getExternalStorageState(). equals(Environment.MEDIA MOUNTED); 

) 


"m 
* 获取 设备 SD 卡 绝对 路 径 
*/ 
public static String getSDCardPath() { 
return Environment. getExternalStorageDirectory().getAbsolutePath(); 
) 


[ux 
* 在 SD 卡 上 创建 目录 
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x*/ 


public static File createDIR(String dirPath) { 


File dir = new File(dirPath); 

if (!dir.exists()) ( 
dir.mkdir(); 

) 

return dir; 


} 


/xx 
* 在 SD 卡 上 创建 文件 
*/ 


// 若 不 存在 文件 夹 , 则 创建 


public static File createFile(String filePath) throws IOException { 


File file = new File(filePath); 
if (!file.exists()) ( 
try { 
file.createNewFile(); 
) catch (Exception e) ( 
e. printStackTrace(); 
) 
) 
return file; 


) 


/*x 
* 判断 文件 是 否 存在 
x/ 


// 若 文件 不 存在 , 则 创建 


public static boolean isFileExists(String filePath) ( 


File file = new File(filePath); 
return file. exists(); 


// 返 回 boolean 类 型 值 ,true: 存在 ; false: 不 存在 


代码 文件 : codes\08\8. 2\SDCardDemo\cn\edu\hstc\sdcarddemo\util\FileUtil. java 
该 工具 类 中 对 SD 卡 的 各 种 读 写 操作 在 源码 中 已 经 做 了 详细 的 注释 ,相信 读者 通过 阅 


读 注释 已 经 对 Android 操作 SD 卡 有 了 初步 的 认 知 ,在 将 本 实例 的 源码 介绍 完整 后 会 对 其 
作 进 一 步 的 总 结 , 接 下 来 ,需要 编写 本 应 用 的 Activity 以 实现 与 用 户 的 交互 。 该 Activity 类 


的 源码 如 下 : 


package cn. edu. hstc. sdcarddemo. activity; 


import java. io. BufferedInputStream; 
import java. io. File; 

import java. io. FileOutputStream; 
import java. io. InputStream; 

import java. io. OutputStream; 

import java. net. URL; 

import java. net. URLConnection; 


import android. app. Activity; 
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import android. app. AlertDialog; 

import android. content. DialogInterface; 
import android. content. DialogInterface. OnCancelListener; 
import android. graphics. Bitmap; 

import android. graphics. BitmapFactory; 
import android. os. AsyncTask; 

import android. os. Bundle; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. Button; 

import android. widget. ImageView; 

import android. widget. LinearLayout; 

import android. widget. TextView; 

import android. widget. Toast; 

import cn. edu. hstc. sdcarddemo. util. DateUtil; 
import cn. edu. hstc. sdcarddemo. util.FileUtil; 


public class MainActivity extends Activity ( 
// 声 明 布 局 中 的 各 个 组 件 
private Button startBtn, showBtn; 
private ImageView image; 
// 图 片 下 载 中 提示 对 话 框 
private AlertDialog prompt; 
// 是 否 有 插入 SD 卡 标识 ,true: 下 载 完 毕 ; false: 未 插入 SDE 
private boolean flag; 
private File file; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. activity main); 
// 通 过 组 件 ID 加 载 界面 布局 中 的 各 个 组 件 
image = (ImageView) findViewById(R. id. image); 
startBtn = (Button) findViewById(R. id. startBtn); 
showBtn = (Button) findViewById(R. id. showBtn); 
startBtn. setOnClickListener(new OnClickListener() ( 

public void onClick(View v) { 
startDownload(); // 开 始 下 载 图 片 


n» 
showBtn. setOnClickListener(new View.OnClickListener() ( 
(2 Override 
public void onClick(View v) { 
if (file != null && file.exists()) { 


Bitmap bm - BitmapFactory.decodeFile(file.getAbsolutePath()); 


image. setImageBitmap(bm); // 将 位 图 加 载 到 图 像 视 图 
} else { 


Toast.makeText(MainActivity.this, "请 先 下 载 图片 "，3000). show(); 


np; 
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) 


private void startDownload() ( 
String pictureUrl = "http://picl.nipic.com/2008 - 12 - 25/2008122510134038 2. jpg"; 
// 创 建 轻 量 级 异步 任务 ,启动 下 载 图 片 
new DownloadFileAsync().execute(pictureUrl); 


// 内 部 类 , 轻 量 级 异步 任务 类 ,继承 AsyncTask 
class DownloadFileAsync extends AsyncTask < String, String, String» ( 
(QOverride 
protected void onPreExecute() { 
super. onPreExecute( ) ; 
prompt = prompt(MainActivity.this, "图 片 下 载 中 ..."); 
prompt. setOnCancelListener(new OnCancelListener() { 
GOverride 
public void onCancel(DialogInterface dialog) { 
cancel(true); 


n; 


(QOverride 
protected String doInBackground(String... params) ( 
int count; 
try { 
URL url = new URL(params[0]); 
URLConnection conexion = url.openConnection(); 
conexion. connect() ; 
int lenghtOfFile = conexion. getContentLength(); 
InputStream input = new BufferedInputStream(url. openStreanm()); 
if (FileUtil. isHaveSDCard()) { // 判 断 设备 是 否 插 入 SD E 
// 创 建文 件 夹 
File dir = FileUtil.createDIR(FileUtil.getSDCardPath() + File. 
separator + "photos"); 
// 在 创建 的 文件 夹 下 创建 文件 ,以 当前 时 间 命 名 图 片 文件 
file = FileUtil.createFile(dir.getAbsolutePath() + File.separator + 
DateUtil. getCurrentDate() + ".jpg"); 
// 创 建文 件 输出 流 ,将 流 写 人 文件 中 
OutputStream output = new FileOutputStream(file); 
byte data[] = new byte[1024]; 
long total - 0; 
while ((count = input.read(data)) != -1) 1{ 
total += count; 
publishProgress("" + (int) ((total * 100) / lenghtOfFile)); 
output.write(data, 0, count); 
) 
output. flush(); 
output. close(); 
input.close(); 
flag - true; 


} eise( 
flag 


false; 

) 
) catch (Exception e) ( 

System. out. println(e.getMessage( 
) 


return null; 


) 


(QOverride 
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).toString()); 


protected void onPostExecute(String unused) ( 


pronmpt.dismiss(); 
if (flag == true) ( 


// 关 闭 提示 对 话 框 


Toast. makeText(MainRctivity.this，" 下 载 完 毕 !"，3000). show() ; 


} else if (flag == false) { 


Toast. makeText(Mainhctivity.this，" 设 备 未 插入 SD 卡 "，3000). show(); 


) 
) 
[xx 


* 返回 提示 对 话 框 
*/ 


private AlertDialog prompt (Activity context, String content) { 


AlertDialog.Builder builder = new AlertD: 


ialog. Builder(context); 


/ /pronpt.. xml 为 对 话 框 布局 ,布局 中 放置 了 ProgressBar 进度 条 以 及 显示 提示 信息 的 TextView 
LinearLayout layout = (LinearLayout) context.getLayoutInflater(). inflate(R. layout. 


prompt, null); 
((TextView) layout. findViewById(R. id. mes. 
builder. setView(layout); 
AlertDialog dialog = builder. show(); 
dialog. setCanceledOnTouchOutside(false); 
return dialog; 


sage)).setText(content); 


代码 文件 : codes\08\8. 2\SDCardDemo\cn\edu\hstc\sdcarddemo\activity\MainActivity. java 


上 面 的 Activity 类 实现 了 与 用 户 的 交互 ,由 于 下 载 的 文件 保存 时 会 以 
其 中 用 到 了 一 个 叫 DateUtil 的 工具 类 ,该 工具 类 用 于 获取 


码 如 下 : 


package cn. edu. hstc. sdcarddemo. util; 


import java. text. SimpleDateFormat; 
import java. util. Date; 


public class DateUtil { 
public static String getCurrentDate() ( 
Date nowDate = new Date(); 
// 日 期 格式 化 


EA 


当前 日 期 命名 , 故 
日 期 并 格式 化 ,该 工具 类 源 


当前 


=] 


SimpleDateFormat format = new SimpleDateFormat("yyyyMMddHHmmss" ) ; 
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return format. format(nowDate); 
) 


代码 文件 : codes VO8 V8. 2\SDCardDemo\cn\edu\hstc\sdcarddemo\util\DateUtil. java 


接 下 来 ,需要 在 应 用 程序 的 清单 文件 中 配置 添加 读 写 SD 卡 的 权限 以 及 访问 网 络 的 权 
限 , 配 置 片段 如 下 所 示 : 


<! -- 访问 网 络 权限 --> 

< uses - permission android:name = "android. permission. INTERNET" /> 

<! -- 在 SD 卡 中 创建 与 删除 文件 权限 --> 

< uses - permission android:name = "android. permission. MOUNT UNMOUNT FILESYSTEMS" /> 
<! -- 往 SD 卡 写 人 数据 权限 --> 

< uses - permission android:name = "android. permission. WRITE_EXTERNAL STORAGE" /> 


至 此 ,简易 型 图 片 下 载 器 的 主要 源码 已 经 全 部 实现 了 。 将 应 用 部 署 在 模拟 器 上 , 单 击 
“开始 下 载 ?按钮 ,运行 效果 如 图 8. 9 Bros o 


BE 12:310» 





8.0 从 网 络 上 下 载 图 片 至 SD 卡 中 


当 图 片 下 载 完 毕 后 ,打开 File Explorer 面板 ,可 以 看 到 如 图 8. 10 所 示 界 面 。 

由 图 8. 10 可 以 看 出 ,SD 卡 的 路 径 为 /mnt/sdcard, 由 于 在 程序 中 实现 了 在 SD 卡 目录 
下 创建 了 一 个 叫 photos 的 文件 夹 并 将 下 载 的 图 片 写 入 该 文件 夹 下 , 故 可 以 看 到 图 片 的 保存 
路 径 为 /mnt/sdcard/photos/ 。 

单 击 界面 中 的 “显示 图 片 ”按钮 ,此 时 会 将 /mnt/sdcard/photos/ 目 录 下 刚才 保存 的 图 片 
文件 读 取出 来 并 显示 在 界面 的 图 像 视 图 中 ,可 以 看 到 如 图 8. 11 所 示 界 面 。 
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4 (» mnt 2015-10-30 12:20 drwxrwxr-x 
b © asec 2015-10-30 12:29 drwxr-xr-x 

4 (5 sdcard 1970-01-01 00:00 d---rwxr-x 

» © DCM 2015-10-19 14:55 d---rwxr-x 

» © LOST.DIR 2015-09-07 1658 d---rwxr-x 

4 © photos 2015-10-30 12:35 d-—rwxr 

国 20151030123152jpg 223067 2015-10-30 1231 ----rwxr-x 


8.10 图 片 保 存 路 径 





BME 12:39 


http;//picl.nipic. — i 
com/2008-12-25/2008122510134038 
-2jpg 











图 8.11 A SD 卡 中 读 取 图 片 并 显示 


总 结 以 上 开发 过 程 ,可 以 看 出 ,操作 Android 设备 SD 卡 中 的 文件 可 以 按照 如 下 步骤 
进行 : 
(D 调用 Environment 的 getExternalStorageState() 方 法 判断 手机 上 是 否 插 入 了 SD 
卡 , 并 且 应 用 程序 具有 读 、 写 SD 卡 的 权限 。 例 如 本 Demo 中 所 用 到 的 FileUtil 类 中 的 代码 
片段 : 
[xx 
* 判断 Android 设备 是 否 插入 了 SD 卡 并 且 应 用 程序 具有 读 写 SD 卡 的 权限 
*/ 
public static Boolean isHaveSDCard() ( 
return Environment. getExternalStorageState().equals(Environment. MEDIA MOUNTED); 


} 


如 果 手 机 已 插入 SD 卡 , 且 应 用 程序 具有 读 写 SD 卡 的 能 力 , 则 该 方法 返回 true。 
© 调用 Environment. getExternalStorageDirectory ( ) 方法 来 获取 外 部 存储 器 , 如 
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FileUtil 工具 类 中 的 代码 片段 : 


[xx 
* 获取 设备 SD 卡 绝对 路 径 
* 
/ 
public static String getSDCardPath() ( 
return Environment. getExternalStorageDirectory().getAbsolutePath(); 
} 
以 上 方法 返回 SD 卡 的 目录 。 
© 使 用 FileInputStream、FileOutputStream、FileReader、FileWriter 读 、 写 SD 卡 里 的 
文件 。 在 本 Demo 中 正 是 使 用 了 FileOutputStream 将 网 络 资源 写 入 SD 卡 中 的 文件 的 。 


6.3 通过 简易 旅游 记录 仪 详细 介绍 SQLite 数据 库 


利用 外 存储 设备 如 SD 卡 存储 数据 毕竟 需要 依赖 外 来 硬件 ,这 有 时 会 给 没有 SD 卡 的 用 
户 带 来 不 便 , 并 不 是 所 有 数据 都 需要 存储 在 外 部 存储 设备 的 。Android 系统 集成 了 一 个 真 
正 轻 量 级 的 数据 库 : SQLite, SQLite 作为 一 个 说 入 式 的 数据 库 引 擎 ,非常 适合 适量 数据 的 
存 取 , 多 用 于 手机 ,平板 等 移动 端 设 备 上 ,一 个 SQLite 数据 库 就 是 一 个 文件 。 


8.3.1 实现 简易 旅游 记录 仪 


简易 旅游 记录 仪 能 帮助 用 户 记录 旅途 中 美好 的 瞬间 ,用 户 通 过 该 应 用 能 将 风景 或 者 其 
他 所 看 到 的 事物 拍 下 来 ,并 对 其 进行 简单 描述 ,然后 保存 起 来 , 当 用 户 过 到 能 歌 善 舞 的 游 伴 
时 ,可 以 利用 该 应 用 将 其 美妙 的 声音 记录 起 来 并 进行 简单 描述 ,然后 保存 起 来 ,过 后 ,用 户 可 
以 通过 翻阅 历史 查看 过 去 的 美好 点 滴 。 

该 简易 旅游 记录 仪 将 用 户 记 录 的 每 一 个 美好 的 事物 作为 一 个 实体 History 保存 在 一 张 
数据 库 表 中 ,这 也 是 实现 该 记录 仪 时 所 需要 掌握 的 知识 点 : Android 操作 SQLite 数据 库 。 
接 下 来 ,让 我 们 一 起 来 实现 该 旅游 记录 仪 的 源 代 码 。 首 先 ,新 建 名 为 SQLiteDemo 的 
Android Application Project ,然后 实现 应 用 启动 界面 。 应 用 主 界面 下 方 为 三 个 菜单 项 ,分 
别 是 查看 照片 类 型 的 历史 查看 音频 类 型 的 历史 .设置 (清空 数据 库 )。 单 击 不 同 的 菜单 项 展 
示 不 同 的 界面 ,应 用 采用 Fragment 技术 实现 该 功能 。 界 面 布 局 代码 如 下 : 

<?xml version = "1.0" encoding = "utf - 8"?» 

< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 

android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:background = "it F5F5F5" 
android:orientation = "vertical" > 


< FrameLayout 
android:id- "(9 + id/realtabcontent" 
android:layout width = "fill parent" 
android:layout height = "Odip" 
android:layout weight = "1" /> 
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< android. support. v4. app. FragnentTabHost 
android: id = "(Zandroid:id/tabhost" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:background = "(2 drawable/buttom back" > 


< FrameLayout 
android: id = "@android: id/tabcontent" 
android:layout width = "Odp" 
android:layout height = "Odp" 
android:layout weight = "0" /> 
«/android. support. v4. app. FragnentTabHost > 


«/LinearLayout > 
代码 文件 : codesVO8 V8. 3NSQLiteDemoVresMlayoutVactivity main.xml 


接着 ,实现 各 个 Fragment 的 布局 ,以 展示 照片 类 型 历史 列表 的 Fragment 为 例 , 代 码 
如 下 : 


<?xml version= "1.0" encoding = "utf - 8"?> 

« LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 
android:orientation = "vertical" > 


< RelativeLayout 
android:id- "(2 + id/layout takephoto" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:background = "(2 color/gainsboro" 
android:padding = "10dp" > 





< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout centerInParent - "true" 
android:text - "Take Photo" 
android:textSize = "22sp" /> 


«/RelativeLayout > 
< ListView 
android:id="@ + id/listView camera" 





android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:divider = "@color/black" 
android:dividerHeight = "1px" /> 


</LinearLayout > 
代码 文件 : codes\08\8.3\SQLiteDemo\res\layout\ fragment camera. xml 
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上 面 的 布局 从 上 而 下 依次 放置 了 一 个 RelativeLayout 布局 ,该 布局 相当 于 一 个 按钮 , 单 
击 将 会 调用 系统 相机 ,一 个 ListView 组 件 用 于 展示 历史 数据 。 展 示 音 频 类 历史 列表 的 
Fragment 的 布局 代码 与 上 面 的 代码 基本 一 样 ,在 此 不 再 重复 给 出 , 单 击 底部 第 三 个 菜单 项 
时 跳 转 到 设置 的 Fragment, 该 Fragment 的 布局 更 加 简单 ,只 是 在 Fragment 中 放置 了 一 个 
用 于 清空 数据 库 的 按钮 ,在 此 也 不 再 重复 给 出 ,可 以 通过 查看 本 书 所 附带 源码 进行 获得 该 部 
分 源码 。 

接着 ,为 了 实现 底部 菜单 项 样式 ,我 们 新 建 了 一 个 叫 tab item. view. xml 的 Layout XC 
件 , 在 该 布局 文件 中 实现 菜单 项 按钮 样式 ,该 文件 源 代码 如 下 所 示 : 


<?xml version = "1.0" encoding = "utf - 8"?> 
< LinearLayout xmlns:android- "http://schemas. android. com/apk/res/android" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:gravity = "center" 
android:orientation = "vertical" > 


< InageView 
android:id- "@ + id/imageview" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:focusable = "false" 
android: padding = "3dp" 
android: src = "(Qdrawable/camera tab btn" /> 


«/LinearLayout > 
代码 文件 : codesVO8 V8. 3NSQLiteDemoVresMlayoutN tab item view.xml 


可 以 看 到 ,上 面 的 代码 对 TextView 组 件 作 了 注释 操作 , 即 在 底部 菜单 按钮 中 屏 项 了 图 
片 下 方 文字 的 展示 ,车 需要 编写 一 个 底部 菜单 按钮 图 片 下 方 带 文字 的 功能 ,可 将 该 部 分 注释 
掉 的 代码 恢复 。 

接 下 来 ,由 于 展示 历史 列表 时 用 到 了 ListView 组 件 ,如 fragment_camera. xml 中 所 示 ， 
故我 们 需要 布局 ListView 组 件 的 样式 , 源 代码 如 下 : 


«?xml version= "1.0" encoding = "utf - 8"?> 
< RelativeLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:paddingBottom = "2dp" 
android:paddingLeft - "20dp" 
android:paddingRight - "20dp" 
android:paddingTop = "2dp" > 


< TextView 
android:id- "(2 * id/txt title" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout alignParentLeft - "true" 
android:layout centerVertical = "true" /> 


985€ 


< TextView 
android:id- "@ + id/txt ge" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout centerVertical - "true" 


android:layout toRightOf = "@id/txt title" 


android:text- "|" /> 


< TextView 
android:id- "(à + id/txt time" 
layout width- "wrap content" 





android:layout height = "wrap content" 
android:layout centerVertical = "true" 


android:layout toRightOf = "@ id/txt ge" /> 


android:id- "(9 + id/image icon" 
id:layout width = "wrap content" 
id:layout height = "wrap content" 
id:layout alignParentRight - "true" 

:layout centerVertical = "true" 





android:background = "(àdrawable/right icon" /> 


«/RelativeLlayout > 
代码 文件 : codesVO8 V8. 3NSQLiteDemoVresVlayoutMlistview item.xml 


面 的 布局 设 定 了 ListView 每 一 个 Item 项 的 样式 。 展 示 图 片 类 型 的 历史 数据 时 , 单 
上 方 的 Take Photo 按钮 将 会 调用 系统 相机 ,拍摄 照片 后 将 会 回 到 列表 页 面 ,此 时 会 
弹出 一 个 对 话 框 供用 户 完善 资料 信息 ,比如 写 下 对 该 照片 的 简单 描述 等 ,该 自 定义 对 话 框 亦 


E 
击 列表 


对 应 一 


个 独立 的 布局 文件 ,该 部 分 源 代码 如 下 : 


<?xml version= "1.0" encoding = "utf — 8"?> 
<LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 


android:layout_width = "match parent" 
android:layout height = "match parent" 
android:orientation = "vertical" 
android:paddingBottom = "5dp" 
android:paddingLeft - "10dp" 
android:paddingRight = "i0dp" 
android:paddingTop = "5dp" > 


< LinearLayout 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
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android:text = "标题 " 
android:textColor = "@color/black" /> 


< EditText 

android:id- "(2 + id/edt title" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout marginLeft = "5dp" 
android:background = "(drawable/contact edit edittext normal" 
android:paddingLeft = "5dp" /> 

«/LinearLayout > 


< LinearLayout 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" 
android:paddingTop = "5dp" > 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "描述 " 
android:textColor = "(Qcolor/black" /> 


« EditText 

android: id = "(à + id/edt content" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout marginLeft - "5dp" 
android:background = "(Qdrawable/contact edit edittext normal" 
android:lines = "4" 
android:paddingLeft = "5dp" /> 

«/LinearLayout > 


< LinearLayout 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:orientation = "horizontal" 
android:paddingTop = "5dp" 
android:layout gravity = "center horizontal" » 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "描述 " 
android: textColor = "@color/black" 
android:visibility = "invisible" /> 


< Button 
android: id= "(2 + id/btn over" 
android:layout width- "wrap content" 
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android:layout height "wrap content" 
android:background = "(Zdrawable/style button" 


android:layout marginLeft - "5dp" 

android:paddingLeft = "30dp" 

android:paddingRight = "30dp" 

android:text = "完成 " /> 
</LinearLayout > 


</LinearLayout > 


该 布局 从 上 而 下 放置 了 两 个 输入 框 用 于 填写 标题 和 描述 ,一 个 Button 按钮 用 于 单 击 完 


成 数据 插入 。 


至 此 ,所 有 页 面 布 局 文件 的 源码 实现 已 经 全 部 完成 ,其 他 辅助 样式 如 自 定义 按钮 的 样式 
等 文件 可 以 通过 本 书 附带 源码 中 获得 (项 目 路 径 为 /res/drawable/)。 

接 下 来 ,需要 实现 的 是 本 应 用 的 主 程序 代码 。 首 先 ,根据 面向 对 象 程序 设计 思想 ,每 一 
个 存 入 数据 库 表 中 的 数据 行 ,都 对 应 了 一 个 具体 的 实体 类 对 象 。 在 本 应 用 中 ,该 实体 类 为 


History 类 ,该 类 实现 代码 如 下 : 


package cn. edu. hstc. sqlitedemo. entity; 
import java. io. Serializable; 


public class History implements Serializable { 


private static final long serialVersionUID - 1L; 


public int id; 

public String title; 
public String content; 
public String filePath; 
public String time; 
public String type; 


public History() ( 
) 


public History(String title, String content, String filePath, String time, String type) { 


this.title - title; 
this.content - content; 
this.filePath - filePath; 
this.time - time; 
this.type - type; 


public History(int id, String title, String content, String filePath, String time, String 


type) { 
this. id = id; 
this.title = title; 
this.content = content; 
this.filePath - filePath; 
this.time - time; 
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this.type = type; 


代码 文件 : codes\08\8.3\SQLiteDemo\cn\edu\hstc\sqlitedemo\entity\History. java 


细心 的 读者 会 发 现 , 该 类 实现 了 Serializable 接口 ,之 所 以 这 么 做 ,是 因为 这 样 可 以 将 整 
个 History 对 象 放 入 Bundle 对 象 中 传递 到 其 他 页 面 中 。 

接 下 来 要 实现 的 是 本 应 用 的 重点 所 在 ,也 是 掌握 SQLite 数据 库 开 发 的 重点 所 在 ,主要 
包括 数据 库 工 具 类 DBHelper 类 以 及 操作 数据 库 的 工具 类 DBManager 类 ,所 有 有 关 数 据 库 
对 基础 操作 都 放 在 这 两 个 工具 类 中 实现 了 。 这 两 个 类 中 所 包含 的 源码 便 是 SQLite 数据 库 
开发 的 知识 点 所 在 。 在 此 ,只 给 出 源码 ,当然 源码 中 会 有 附带 相关 注释 ,更 详细 的 知识 点 将 
在 下 一 节 介 绍 。 

首先 , 先 来 看 看 实际 操作 创建 数据 库 文件 的 类 DBHelper 的 源 代码 : 


package cn. edu. hstc. sqlitedemo. util; 


import android. content. Context; 
import android. database. sqlite. SQLiteDatabase; 
import android. database. sqlite. SQLiteOpenHelper; 


public class DBHelper extends SQLiteOpenHelper { 
// 数 据 库 文件 名 
private static final String DATABASE NAME = "sqlitedemo. db"; 
private static final int DATABASE VERSION - 1; 


public DBHelper(Context context) ( 

//CursorFactory iW Jg null, 使 用 默认 值 

super(context, DATABASE NAME, null, DATABASE VERSION); 
) 


// 数 据 库 第 一 次 被 创建 时 onCreate 会 被 调用 
(QOverride 
public void onCreate(SQLiteDatabase db) ( 
db. execSQL (" create table if not exists history" + "( id integer primary key 
autoincrement, title varchar, content varchar, filePath varchar, time varchar, type 
varchar)"); 
) 


// 如 果 DATABASE VERSION 值 被 改 为 2, 系统 发 现 现 有 数据 库 版 本 不 同 , 即 会 调用 onUpgrade 
@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
db. execSQL( "alter table history add column other string"); 
) 


代码 文件 : codes\08\8.3\SQLiteDemo\cn\edu\hstc\sqlitedemo\util\DBHelper. java 
上 面 的 工具 类 做 了 创建 数据 库 文件 的 实际 操作 ,在 下 一 节 将 会 详细 讲解 该 类 ,此 处 只 给 
出 源码 。 接 下 来 ,需要 实现 另 一 个 工具 类 DBManager 类 ,用 于 实现 数据 库 的 数据 操作 功能 ， 
源 代码 如 下 : 
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package cn. edu. hstc. sqlitedemo. util; 


import java. util. ArrayList; 
import java. util. List; 


import android. content. Context; 

import android. database. Cursor; 

import android. database. sqlite. SQLiteDatabase; 
import cn. edu. hstc. sqlitedemo. entity. History; 


public class DBManager { 
private DBHelper helper; 
private SQLiteDatabase db; 


public DBManager(Context context) ( 
helper - new DBHelper(context); 
// 因 为 getWritableDatabase 内 部 调用 了 mContext. openOrCreateDatabase (nName, 0, 
mFactory); 
// 所 以 要 确保 context. 已 初始 化 , 可 以 把 实例 化 DBManager 的 步骤 放 在 Activity 的 
onCreate 里 
db = helper.getWritableDatabase(); 


} 

public void add(History history) { 
db. beginTransaction(); // 开 始 事务 
try { 


db. execSQL(" insert into history values(null, ?, ?, ?, ?, ?)", new Object[] 
{history. title, history. content, history.filePath, history. time, history.type]); 
db. setTransactionSuccessful(); // 设 置 事务 成 功 完成 

} catch (Exception e) { 

} finally { 
db. endTransaction(); // 结 束 事务 


public void add(List <History> histories) { 
db. beginTransaction(); // 开 始 事务 
try{ 
for (History history : histories) { 
db. execSQL(" insert into history values(null, ?, ?, ?, ?, ?)", new Object[ ] 
{history. title, history.content, history.filePath, history.time, history.type]); 


) 

db. setTransactionSuccessful(); /设置 事务 成 功 完成 
} catch (Exception e) ( 
) finally ( 

db. endTransaction(); // 结 束 事务 


/ * public void addContact(List < Contact > contacts) ( 
db. beginTransaction(); // 开 始 事务 
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try { 
for (Contact contact : contacts) { 
db. execSQL(" insert into contact values (null, ?, ?, ?, ?, ?, ?, ?, ?)", new 
Object[ ] ( contact. name, contact. phone, contact. email, contact. company, contact. title, 
contact. address, contact. website, contact. theId]); 
} 


db. setTransactionSuccessful(); // 设 置 事务 成 功 完成 
} catch (Exception e) ( 
) finally ( 

db. endTransaction(); // 结 束 事务 


} 
)*/ 


public void delete(int theId) { 

db. beginTransaction(); 

try( 
db. execSQL("delete from history where id-" + theId); 
db. setTransactionSuccessful(); 

) catch (Exception e) ( 

) finally ( 
db. endTransaction(); 


public void getLastId(String table name) ( 
) 


public void deleteTableHistory() { 
db.delete("history", null, null); 


public List «History» query(String[] type) { 

ArrayList «History» histories = new ArrayList «History»(); 

Cursor cursor - queryTheCursor(type); 

while (cursor.moveToNext()) ( 
History history = new History(); 
history. id = cursor.getInt(cursor.getColumnIndex(" id")); 
history.title = cursor.getString(cursor.getColumnIndex("title")); 
history. content = cursor.getString(cursor. getColumnIndex("content")); 
history.filePath = cursor.getString(cursor.getColumnIndex("filePath")); 
history.time - cursor.getString(cursor.getColumnIndex("time")); 
history. type = cursor.getString(cursor.getColumnIndex("type")); 
histories.add(history); 

) 

cursor.close(); 

return histories; 


public Cursor queryTheNew(String[] time) ( 
Cursor c = db.rawQuery("select * from history where time - ?", time); 
return c; 
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) 


public Cursor queryTheCursor(String[] type) { 
Cursor c = db.rawQuery("select * from history where type =? order by id desc", 
type); 
return c; 


) 


public Cursor queryTheCursorl(String[] whereStr) ( 
Cursor c = db.rawQuery("select * from history where title= ? or time - ?", whereStr); 
return c; 


} 


public void deleteTheTable(String tableName) { 
if (hasTable(tableName)) { 
db. execSQL("delete from " + tableName); 
) 
) 


public void closeDB() ( 
db.close(); 
) 


public boolean hasTable(String table name) ( 
boolean result - false; 
Cursor cur = null; 
try ( 
String sql table = "select count( * ) as c from Sqlite master where type = 'table' 
and name = '" + table name.trim() + "'"; 
cur = db.rawQuery(sql table, null); 
if (cur.moveToNext()) ( 
int count - cur.getInt(0); 
if (count > 0) ( 
result - true; 
) 
) 
cur. close(); 
) catch (Exception e) ( 
return result; 


) 


return result; 


代码 文件 : codes\08\8. 3\SQLiteDemo\cn\edu\hstc\sqlitedemo\util\DBManager. java 


上 述 源码 做 了 操作 数据 库 表 的 数据 的 实际 操作 ,具体 就 是 数据 库 的 增 、 删 、 改 、 查 。 实 际 
上 ,该 工具 类 还 可 继续 完善 , 随 着 APP 业务 需求 的 增多 以 及 繁杂 度 的 加 大 ,可 以 向 该 类 添加 
更 多 的 数据 库 操作 的 方法 。 接 下 来 ,介绍 本 应 用 中 涉及 的 另 一 个 工具 类 一 一 自 定义 
ListView 适配器 MyListViewAdapter 类 , 源 代码 如 下 所 示 : 
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package cn. edu. hstc. sql itedemo. util; 


import java. util. ArrayList; 
import java. util. List; 


import android. content. Context; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget. BaseAdapter; 

import android. widget. TextView; 

import cn. edu. hstc. sqlitedemo. activity. R; 
import cn. edu. hstc. sqlitedemo. entity.History; 


public class MyListViewAdapter extends BaseAdapter ( 
// 填 充 ListView 的 数据 源 
private List < History» listHistories = new ArrayList «History»^(); 
private LayoutInflater inflater; 


// 在 构造 器 中 注 和 数据 源 ListHistories 

public MyListViewAdapter(Context context，List< History» listHistories) { 
this.listHistories - listHistories; 
inflater = (LayoutInflater) context.getSystemService(Context. LAYOUT INFLATER 
SERVICE); 


(QOverride 
public int getCount() ( 
return listHistories.size(); 


(QOverride 
public Object getItem(int position) ( 
return listHistories.get(position); 


@Override 
public long getItemId( int position) { 
return position; 


// 自 定义 列表 项 
(QOverride 
public View getView(int position, View convertView, ViewGroup parent) { 
ViewHolder holder = null; 
if (convertView == null) { 
// 加 载 列表 项 布局 文件 
convertView = inflater.inflate(R.layout.listview item, null); 
holder - new ViewHolder(); 
holder.title = (TextView) convertView.findViewById(R. id.txt title); 
holder. time = (TextView) convertView.findViewById(R. id. txt time); 
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convertView. setTag( holder); 
} else { 

holder = (ViewHolder)convertView.getTag(); 
} 
holder.title.setText(listHistories.get(position).title); 
holder.time.setText(listHistories.get(position).time); 
return convertView; 


} 


// 更 新 数据 ,刷新 ListView 

public void addItem(final History history) { 
listHistories.add(history); 
notifyDataSetChanged( ); 

) 


public static class ViewHolder { 
public TextView title; 
public TextView time; 


代码 文件 : codes\08\8.3\SQLiteDemo\cn\edu\hstc\sqlitedemo\util\MyListViewAdapter. java 


上 述 工具 类 作为 ListView 组 件 的 自 定义 适配器 ,在 调用 时 ,只 需 创建 该 类 对 象 并 传人 
List 数组 的 数据 源 , 便 可 将 数据 填充 到 ListView 中 ,非常 方便 。 这 在 本 书 第 4 章 中 介绍 
ListView 列表 组 件 时 就 有 所 介绍 ,对 这 部 分 知识 点 不 熟悉 的 读者 可 以 翻阅 之 前 的 章节 进行 
巩固 。 

当 用 户 使 用 该 应 用 拍摄 照片 或 者 录制 音频 文件 后 ,会 自动 将 所 拍摄 的 照片 或 录制 的 音 
频 文 件 进行 保存 到 本 地 的 操作 ,此 时 会 使 用 精确 到 秒 的 当前 系统 时 间作 为 该 文件 的 文件 名 ， 
故 在 本 应 用 中 还 涉及 到 另外 两 个 工具 类 一 一 DateUtil 类 以 及 FileUtil 类 。DateUtil 类 主要 
是 返回 任意 格式 的 系统 当前 时 间 ,FileUtil 类 主要 是 操作 文件 以 及 SD 卡 , 例 如 ,将 任意 文件 
复制 到 另 一 个 任意 目录 下 。 读 者 可 以 通过 阅读 本 书 所 附带 源码 来 获取 这 两 个 类 的 源码 。 

本 应 用 采用 Fragment 技术 实现 底部 三 个 菜单 的 界面 切换 ,因此 需要 实现 三 个 菜单 各 
自 的 Fragment 组 件 。 首 先 , 实 现 第 一 个 菜单 按钮 所 对 应 的 Fragment 及 其 功能 。 源 码 
如 下 : 


package cn. edu. hstc. sqlitedemo. fragment; 


import java. io. File; 

import java. io. FileNotFoundException; 
import java. io. FileOutputStream; 
import java. io. IOException; 

import java.util.ArrayList; 

import java.util.List; 


import android. app. Activity; 
import android. app. AlertDialog; 
import android. content. Context; 
import android. content. Intent; 
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import android. database. Cursor; 

import android. graphics. Bitmap; 

import android. os. Bundle; 

import android. os. Environment; 

import android. provider. MediaStore; 

import android. support. v4. app. Fragment; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget. AdapterView; 

import android. widget. AdapterView. OnItemClickListener; 
import android. widget. Button; 

import android. widget. EditText; 

import android. widget. ListView; 

import android. widget. RelativeLayout; 

import android. widget. Toast; 

import cn. edu. hstc. sqlitedemo. activity. MainActivity; 
import cn. edu. hstc. sqlitedemo. activity. R; 

import cn. edu. hstc. sqlitedemo. activity. ShowCameraActivity; 
import cn. edu. hstc. sqlitedemo. entity.History; 

import cn. edu. hstc. sqlitedemo. util.DateUtil; 

import cn. edu. hstc. sqlitedemo. util.FileUtil; 

import cn. edu. hstc. sqlitedemo. util. MyListViewAdapter; 


public class CameraHistroyFragment extends Fragment ( 
private MyListViewAdapter cameraAdapter; // 自 定义 ListView 适配器 
private ListView cameraListView; / /ListView 组 件 , 用 于 显示 照片 类 型 的 历史 列表 
private RelativeLayout takephotoLayout;  // 在 顶部 单 击 调用 系统 照相 机 的 按钮 
private List «History» historyList; //List 集合 ,存放 数据 库 表 对 应 的 实体 


(QOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle 
savedInstanceState) { 

return inflater. inflate(R. layout. fragment camera, null); 


(&Override 

public void onActivityCreated(Bundle savedInstanceState) ( 
super. onActivityCreated(savedInstanceState); 
// 初 始 化 ListView 


initListView(); 


(QOverride 
public void onActivityResult(int requestCode, int resultCode, Intent data) { 
super.onActivityResult(requestCode, resultCode, data); 
if (requestCode -- 1 && resultCode == Activity.RESULT OK) { 
boolean flag - true; 
String sdStatus - Environment.getExternalStorageState(); 
if (!sdStatus.equals(Environment.MEDIA MOUNTED)) ( // 检 测 SD 卡 是 否 可 用 
Toast. makeText(getactivity()，" 存 储 设 备 未 插入 "，3000). show(); 


) 
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return; 


if (data != null)( 


"sqlitedemo"); 


"inages"); 


content); 


Bundle bundle - data.getExtras(); 
Bitmap bitmap (Bitmap) bundle. get("data"); 
// 获 取 相机 返回 的 数据 ,并 转换 为 Bitmap 图 片 格式 


" 


FileOutputStream b - null; 
Filedirl = FileUtil.createDIR(FileUtil.getSDCardPath() + File.separator 十 


File dir2 = FileUtil.createDIR(dirl.getAbsolutePath() + File. separator + 


final String fileName = dir2.getAbsolutePath() + File. separator + 
DateUtil. getCurrentDate() + ". jpg"; 
try { 
b = new FileOutputStream(fileName); 
bitmap. compress(Bitmap. CompressFormat. JPEG, 100, b); // 把 数据 写 入 文件 
Toast.makeText(getActivity(), "HE Hr Ef f£", 3000). show(); 
} catch (FileNotFoundException e) { 
e. printStackTrace(); 
flag - false; 
Toast.makeText(getActivity(), "HT (& ff th fi", 3000). show() ; 
) finally ( 
try { 
b. flush(); 
b.close(); 
) catch (IOException e) ( 
e. printStackTrace(); 


) 

if (flag == true) ( 
AlertDialog.Builder builder = new AlertDialog.Builder(getActivity()); 
LayoutInflater inflater = (LayoutInflater) getActivity(). 
getSystemService(Context. LAYOUT INFLATER SERVICE); 
View layout = inflater.inflate(R.layout.dialog input, null); 
builder.setView(layout); 
builder. setTitle(" 完 善 此 刻 想 说 的 话 ") ; 
final AlertDialog dialog = builder. show(); 
Button button = (Button) layout.findViewById(R. id.btn over); 
final EditText titleEdt = (EditText) layout. findViewById(R. id. edt title); 
final EditText contentEdt = (EditText) layout. findViewById(R. id. edt - 


button. setOnClickListener(new View.OnClickListener() ( 
@Override 
public void onClick(View v) { 
if (dialog != null) ( 

String title = titleEdt.getText().toString(); 
String content = contentEdt.getText().toString(); 
String time = DateUtil.getCurrentDatel(); 
String type - "camera"; 
MainActivity.dbManager. add(new History(title, content, 
fileName, time, type)); 
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dialog.dismiss(); 
String timeRaw[] = {time}; 
History history = queryNew(timeRaw); 
historyList.add(0, history); 
cameraAdapter. notifyDataSetChanged(); 
) 
) 
ni 
} 
} 
} 
} 
/* 
* 查找 数据 库 , 将 数据 填充 在 ListView 中 
*/ 


private void initListView() { 
takephotoLayout = (RelativeLayout) getActivity().findViewById(R. id. layout_ 
takephoto); 
takephotoLayout. setOnClickListener(new View.OnClickListener() ( 
(2 Override 
public void onClick(View v) ( 
Intent intent = new Intent(MediaStore. ACTION IMAGE CAPTURE); 
startActivityForResult(intent, 1); 


n; 


String[] typeRaw = ( "camera" ); 
historyList = handleDB(typeRaw); // 查 询 表 ,并 将 查找 出 来 的 数据 拼装 到 List 集合 中 
// 将 查询 出 来 的 数据 作为 数据 源 填充 到 ListView 适配器 中 
cameraAdapter = new MyListViewAdapter (CameraHistroyFragment. this. getActivity( ), 
historyList); 
cameraListView = (ListView) CameraHistroyFragment. this. getActivity(). findViewById 
(R. id.listView camera); 
caneraListView. setAdapter(cameraAdapter); 
cameraListView. setOnItemClickListener(new OnItemClickListener() ( 
(QOverride 
public void onltemClick(AdapterView <?> arg0, View argl, int arg2, long arg3) { 
History history = historyList.get(arg2); 
Intent intent = new Intent(CameraHistroyFragment. this.getActivity(), 
ShowCameraActivity.class); 
Bundle bundle = new Bundle(); 
bundle. putSerializable("history", history); 
intent. putExtras(bundle); 
startActivity(intent); 


n; 


/xx 
* 操作 数据 库 , 查询 表 
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x*/ 
private List <History> handleDB(String[] typeRaw) ( 

List«History» historyList = new ArrayList «History»(); 

Cursor cursor = null; 

// 使 用 dbManager 数据 库 操作 工具 查询 满足 条 件 的 数据 填充 游标 

cursor = MainActivity. dbManager. queryTheCursor(typeRaw) ; 

// 托 付 给 activity 根据 自己 的 生命 周期 去 管理 Cursor 的 生命 周期 

CaneraHistroyFragment. this. getActivity(). startManagingCursor(cursor); 

while (cursor.moveToNext()) { // 开 始 将 查询 出 来 的 数据 添加 在 List 数组 中 
int id = cursor.getInt(0); 
String title = cursor.getString(1); 
String content = cursor.getString(2); 
String filePath = cursor.getString(3); 
String time = cursor.getString(4); 
String type = cursor.getString(5); 
History history = new History( id, title, content, filePath, time, type); 
historyList.add(history); 

) 

return historyList; 


) 


/ xx 
* 查询 最 新 一 条 数据 
*/ 
private History queryNew(String[] timeRaw) { 
Cursor cursor - null; 
// 根 据 时 间 字 段 查询 单条 数据 
cursor = MainActivity. dbManager. queryTheNew(timeRaw); 
// 托 付 给 activity 根据 自己 的 生命 周期 去 管理 Cursor 的 生命 周期 
CameraHistroyFragment. this. getActivity(). startManagingCursor(cursor); 
while (cursor. moveToNext()) { 
int id = cursor.getInt(0); 
String title = cursor. getString(1); 
String content - cursor.getString(2); 
String filePath = cursor.getString(3); 
String time - cursor.getString(4); 
String type - cursor.getString(5); 
History history = new History( id, title, content, filePath, time, type); 
return history; 
) 


return null; 


i 代码 文件 : codes V 08 V 8. 3 \ SQLiteDemo V cn V edu V hstc V sqlitedemo V fragment V 

CameraHistroyFragnent. java 

上 面 文件 中 的 程序 实现 了 单 击 项 部 按钮 调用 系统 照相 机 ,照相 之 后 返回 该 Fragment 
并 将 所 拍摄 的 照片 保存 在 手机 SD 卡 的 指定 文件 夹 中 ,并 记 住所 保存 的 绝对 路 径 ,然后 弹出 
一 个 对 话 框 供用 户 填 写 标题 以 及 对 该 照片 的 简单 描述 , 单 击 对 话 框 中 的 完成 按钮 将 会 生成 
一 条 新 的 History 数据 ,该 History 数据 的 title 属性 和 content 属性 为 用 户 在 对 话 框 中 所 填 
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写 的 标题 和 简 述 fileName 属性 为 照片 的 保存 路 径 ,time 属性 为 系统 当前 时 间 ,type 属性 为 
camera 字符 串 ,最 后 调用 数据 库 操 作 工具 类 实现 将 该 条 数据 作为 数据 库 表 的 一 条 记录 保存 
到 数据 库 中 并 刷新 ListView 列表 。 

当然 ,上 面 程序 必然 会 涉及 数据 库 查 询 操作 ,将 查询 到 的 数据 作为 ListView 数据 源 填 
充 到 ListView 中 。 单 击 ListView 列表 中 的 某 一 列表 项 ,将 会 把 该 列表 项 所 对 应 的 History 
实体 类 放 在 Bundle 中 并 传递 到 历史 记录 详情 页 面 。 该 详情 页 面 的 实现 并 不 是 本 章 的 学 习 
重点 ,在 此 不 提供 代码 ,读者 可 以 通过 阅读 本 书 所 附带 项 目 源 码 获取 该 页 面 实现 源码 。 

单 击 底部 菜单 中 的 第 二 个 菜单 项 ,界面 将 会 显示 其 对 应 的 第 二 个 Fragment 一 一 
AudioHistoryFragment。 该 Fragment 的 实现 与 CameraHistoryFragment 的 实现 类 似 ,只 
不 过 调用 的 系统 工具 为 设备 的 录音 功能 ,保存 的 文件 也 不 再 是 照片 而 是 一 段 音频 ,当然 保存 
到 数据 库 所 对 应 的 History 数据 中 的 type 字段 也 将 保存 为 audio, 页 面 中 展示 历史 数据 也 
是 用 ListView 组 件 , 单 击 其 某 个 列表 项 也 会 跳 转 到 对 应 的 详情 页 面 , 在 该 详情 页 面 展 示 的 
不 再 是 照片 而 是 一 段 音频 , 单 击 即 可 实现 播放 与 停止 。 因 此 ,AudioHistoryFragment 类 以 
及 对 应 的 详情 页 面 的 实现 源码 都 可 通过 本 书 附带 源码 获取 。 

底部 菜单 中 提供 了 第 三 个 菜单 供用 户 单 击 显示 第 三 个 Fragment 一 一 SettingFragment。 
该 Fragment 放置 了 一 个 按钮 供用 户 单 击 以 清空 数据 库 , 实 现 源码 如 下 : 


package cn. edu. hstc. sqlitedemo. fragment; 


import android. app. AlertDialog; 

import android. content.DialogInterface; 

import android. content. DialogInterface. OnClickListener; 
import android. os. Bundle; 

import android. support. v4. app. Fragment; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget.RelativeLayout; 

import android. widget. Toast; 

import cn. edu. hstc. sqlitedemo. activity.MainActivity; 
import cn. edu. hstc. sqlitedemo. activity. R; 


public class SettingFragnent extends Fragment ( 
private RelativeLayout settingLayout; 


(QOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle 
savedInstanceState) ( 
return inflater. inflate(R. layout.fragment setting, null); 
} 


@Override 

public void onActivityCreated(Bundle savedInstanceState) { 
super. onActivityCreated( savedInstanceState); 
initView(); 
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} 


private void initView() { 
settingLayout = (RelativeLayout) getActivity().findViewById(R. id. layout cleardb); 
settingLayout. setOnClickListener(new View. OnClickListener() { 
@Override 
public void onClick(View v) { 
AlertDialog.Builder builder = new AlertDialog.Builder(getActivity()); 
builder. setMessage( "确认 清空 所 有 数据 吗 ?"); 
builder. setTitle(" 提 示 "); 
builder. setPositiveButton(" 确 认 "，new OnClickListener() { 
(QOverride 
public void onClick(DialogInterface dialog, int which) { 
// 调 用 数据 库 操作 工具 类 删除 表 数 据 
MainActivity. dbManager. deleteTheTable( "history"); 
dialog.dismiss(); 
Toast. makeText(getActivity(), "清空 数据 完毕 "，3000). show() ; 
} 
ni 
builder. setNegativeButton("Htifj", new OnClickListener() { 
(Q Override 
public void onClick(DialogInterface dialog, int which) { 
dialog.dismiss(); 
) 
H; 
builder. create(). show( ) ; 


n; 


} 
代码 文件 : codes V 08 \ 8. 3 \ SQLiteDemo V cn V edu V hstc V sqlitedemo V fragment V 
SettingFragnent. java 


上 面 程 序 最 核心 的 一 行 代码 就 是 MainActivity. dbManager. delete The Table ("history") , 通 
过 该 行 代码 调用 数据 库 操作 工具 类 来 删除 history 表 中 的 全 部 数据 ,实现 了 清空 所 有 数据 的 
功能 。 当 然 底层 的 数据 库 操作 依旧 是 在 上 面 所 介绍 的 DBManager 工具 类 中 实现 的 。 该 工 
具 类 的 实现 与 完善 才 是 本 章 的 重点 ,Android 操作 SQLite 数据 库 的 实际 工作 便 是 在 该 工具 
类 中 实现 的 。 

接 下 来 ,需要 将 上 面 的 这 三 个 Fragment 整合 到 Activity 中 才能 实现 与 用 户 的 交互 。 该 
Activity 也 是 应 用 的 入 口 Activity ,源码 实现 如 下 : 


package cn. edu. hstc. sqlitedemo. activity; 


import android. content. Intent; 

import android. os. Bundle; 

import android. support. v4. app. FragmentActivity; 
import android. support. v4. app. FragnentTabHost ; 
import android. view. LayoutInflater; 
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import android. view. View; 

import android. view. Window; 

import android. widget. ImageView; 

import android. widget. TabHost. TabSpec; 

import cn. edu. hstc. sqlitedemo. fragment. AudioHistoryFragment; 
import cn. edu. hstc. sqlitedemo. fragment. CameraHistroyFragment; 
import cn. edu. hstc. sqlitedemo. fragment. SettingFragment; 
import cn. edu. hstc. sqlitedemo. util. DBManager; 


public class MainActivity extends FragmentActivity ( 

private FragmentTabHost tabHost; 

private LayoutInflater layoutInflater; 

// 定 义 数组 来 存放 Fragment 界面 

private Class <?> fragmentArr[] = ( CameraHistroyFragment. class, AudioHistoryFragment. 
class, SettingFragment. class } 7 

// 定 义 数组 来 存放 底部 按钮 图 片 

private int tabImageArr[] = { R.drawable.camera tab btn, R. drawable. audio_tab_btn, R. 
drawable.setting tab _ btn }; 

// 定 义 数组 来 存放 底部 选项 卡 文字 

private String tabTextArr[] = { "Camera", "Audio", "Setting"}; 

public static DBManager dbManager; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
this.requestWindowFeature(Window.FEATURE NO TITLE); ”// 去 掉 标题 栏 
setContentView(R. layout.activity main); 
// 创 建 DBManager X1 
dbManager = new DBManager(MainActivity. this); 


initView(); 


(QOverride 
protected void onActivityResult(int arg0, int argl, Intent arg2) ( 
super.onActivityResult(arg0, argl, arg2); 


private void initView() { 
// 实 例 化 布局 对 象 
layoutInflater = LayoutInflater.from(this); 
tabHost = (FragmentTabHost) this. findViewById(android.R. id. tabhost) ; 
tabHost.setup(this, getSupportFragmentManager(), R. id. realtabcontent); 
int count = fragnmentArr. length; 
for (inti = 0; i< count; i++) ( 
// 为 每 一 个 Tab 按钮 设置 图 标 文字 
TabSpec tabSpec = tabHost. newTabSpec(tabTextarr[i]). setIndicator 
(getTabItenView(i)); 
tabHost.addTab(tabSpec, fragmentArr[i], null); 
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tabHost. getTabWidget(). getChildat(i). setBackgroundResource(R. drawable. 
selector tab background); 


/** 


* 


* 


给 Tab 按钮 设置 图 标 和 文字 
/ 


private View getTabItenView(int index) ( 


View view = layoutInflater.inflate(R.layout.tab item view, null); 
ImageView imageView = (ImageView) view.findViewById(R. id. imageview); 
imageView. setImageResource(tabImageArr[index]); 


return view; 


代码 文件 : codes V8 V8. 3\SQLiteDemo\cn\edu\hstc\sqlitedemo\activity\MainActivity. java 


至 此 ,简易 旅游 记录 仪 的 所 有 代码 实现 便 已 介绍 完毕 。 接 下 来 主要 探讨 的 是 该 应 用 源 
牢 


码 中 的 DBHelper 类 以 及 DBManager 类 ,以 便 读者 更 


固 地 掌握 Android SQLite 知识 。 将 


程序 部 署 在 Android 设备 上 并 使 用 ,图 8. 12 一 图 8. 15 是 一 些 操 作 界面 。 
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图 8.12 历史 列表 图 8.13 调用 系统 录音 设备 





249 


(e Android 应 用 开发 从 入 门 到 精通 


BM G 6:58 BM G 6:59am 





(© 完善 此 刻 想 说 的 话 


请 键入 标题 


请 键入 描述 








图 8.14 完善 数据 图 8.15 清空 数据 库 


8.3.2 齐 析 简易 旅游 记录 仪 


通过 了 8.3.1 节 对 简易 旅游 记录 仪 的 实现 ,相信 读者 已 基本 了 解 了 Android 是 如 何 操 
作 SQLite 数据 库 的 。 接 下 来 ,将 对 该 应 用 的 两 个 关键 类 的 源码 进行 剖析 ,以 帮助 读者 加 深 
对 SQLite 数据 库 操 作 的 理解 。 首 先 , 再 次 将 创建 数据 库 的 类 DBHelper 的 源码 在 下 面 
With 


package cn. edu. hstc. sqlitedemo. util; 


import android. content. Context; 
import android. database. sqlite. SQLiteDatabase; 
import android. database. sqlite. SOLiteOpenHelper; 


public class DBHelper extends SQLiteOpenHelper { 
// 数 据 库 文件 名 
private static final String DATABASE NAME 
Private static final int DATABASE VERSION 


= "sglitedemo. db"; 
= 1; 
public DBHelper(Context context) { 

//CursorFactory 设置 为 null, 使 用 默认 值 

super(context, DATABASE NAME, null, DATABASE VERSION); 
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// 数 据 库 第 一 次 被 创建 时 onCreate 会 被 调用 
@Override 
public void onCreate(SQLiteDatabase db) { 
db. execSQL( "create table if not exists history" + "( id integer primary key autoincrement, 
title varchar, content varchar, filePath varchar, time varchar, type varchar)"); 
) 


// 如 果 DATABASE VERSION 值 被 改 为 2, 系 统 发 现 现 有 数据 库 版 本 不 同 , 即 会 调用 onUpgrade 
(QOverride 
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) ( 
db. execSQL( "alter table history add column other string"); 
) 
h 


通过 阅读 上 面 程序 源码 可 以 发 现 ,帮助 我 们 创建 了 SQLite 数据 库 的 类 继承 了 
SQLiteOpenHelper 类 。 该 类 是 SQLiteDatabase 的 一 个 帮助 类 ,用 来 管理 数据 库 的 创建 和 
版 本 的 更 新 ,一 般 是 建立 一 个 类 继承 它 并 实现 它 的 onCreate 和 onUpgrade 方法 。 
SQLiteOpenHelper 类 具有 如 表 8. 1 所 示 的 一 些 方法 。 


表 8.1 SQLiteOpenHelper 类 的 方法 

















方 法 名 方法 描述 
SQLiteOpenHelper ( Context context, String name, | 构造 方法 ,一 般 把 要 创建 的 数据 库 的 名 称 作 为 
SQLiteDatabase. CursorFactory factory ,int version) 参数 进行 传递 
onCreate( SQLiteDatabase db) 创建 数据 库 时 调用 
DR (SQLiteDatabase db, int oldVersion， int 版 本 更 新 时 调用 
newVersion) 
getReadableDatabase() 创建 或 打开 一 个 只 读数 据 库 
getWritableDatabase() 创建 或 打开 一 个 读 写 数 据 库 





在 此 ,姑且 先 不 去 研究 程序 是 怎么 创建 sqlitedemo. db 这 个 数据 库 文件 的 。 从 自 定义 
的 DBHelper 类 中 ,可 以 看 到 ,我 们 是 在 onCreate 方法 中 调用 了 SQLiteDatabase 对 象 的 
execSQL 方法 来 创建 了 一 张 名 为 history 的 数据 库 表 。SQLiteDatabase 类 提供 了 很 多 实际 
操作 数据 库 的 方法 ,较为 常用 的 方法 如 表 8. 2 所 示 。 


表 8.2 SQLiteDatabase 类 提供 的 常用 方法 




















(返回 值 ) 方 法 名 方法 描述 

(int) delete(String table, Stri hereClause, Stri P 

int) delete(String table, String whereClause, String[ ] 删除 数据 行 的 便捷 方法 
whereArgs) 
a ) i t CStri table. Stri llCol Hack, - 

ong inser! ring table ring nul ‘Olumn Hac! 添加 数据 行 的 便捷 方法 
ContentValues values) 
Cint) update (String table. ContentValues values. p 
String whereClause, String[ ] whereArgs) 更 新 数据 行 的 便捷 方法 

执行 一 个 SQL 语句 ,可 以 是 一 个 select 或 其 他 的 

(void) execSQL String sql) SQL 2 " indio 
(void) close() 关闭 数据 库 
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续 表 


(返回 值 ) 方 法 名 方法 描述 
(Cursor) query(String table, String[ ] columns, String 
selection. String [ ] selectionArgs. String groupBy. | 查询 指定 的 数据 表 返 回 一 个 带 游标 的 数据 集 
String having. String orderBy，String limit) 








运行 一 个 预 置 的 SQL 语句 ,返回 带 游标 的 数据 集 


(Cursor) rawQuery(String sql, String[ | selectionArgs) (与 上 面 的 语句 最 大 的 区 别 就 是 防止 SQL 注入 ) 





在 DBHelper 类 中 正 是 使 用 了 SQLiteDatabase 类 中 的 execSQL(String sql) 方 法 来 执 
行 一 段 创建 数据 库 表 的 SQL 语句 。 
实际 上 ,SQLiteDatabase 类 代表 了 一 个 数据 库 , 一 旦 应 用 程序 获得 了 代表 指定 数据 库 
的 SQLiteDatabase 对 象 , 接 下 来 就 可 以 通过 其 对 象 来 管理 和 操作 数据 库 了 。 可 是 ,程序 是 
如 何 创 建 SQLiteDatabase 数据 库 的 呢 ? 这 也 要 归功 于 SQLiteDatabase。SQLiteDatabase 
提供 了 如 表 8. 3 所 示 的 静态 方法 来 打开 或 创建 数据 库 文件 。 
表 8.3 SQLiteDatabase 类 提供 的 打开 或 创建 数据 库 文件 的 方法 
(返回 值 ) 方 法 名 方法 描述 


static SQLiteDatabase openDatabase (String path, 





打开 path 文件 所 代表 的 SQLite 数据 库 


SQLiteDatabase. CursorFactory factory, int flags) 





static. SQLiteDatabase openOrCreateDatabase ( File 
fil SQLi 
file» SQLiteDatabase. CursorFactory factory) 打开 或 创建 file 文件 所 代表 的 SQLite 数据 库 


static SQLiteDatabase openOrCreateDatabase (String| 打开 或 创建 path 路 径 下 文件 所 代表 的 SQLite 数 
path，SQLiteDatabase. CursorFactory factory) 据 库 








从 上 面 的 DBHelper 类 的 源码 中 ,我 们 并 没有 看 到 以 上 打开 或 创建 数据 库 文件 的 代码 ， 
那么 程序 在 哪里 调用 了 SQLiteDatabase 对 象 来 创建 数据 库 呢 ? 答案 就 在 DBManager 类 源 
码 中 。 在 此 ,将 DBManager 类 的 源码 再 次 贴 出 : 


package cn. edu. hstc. sqlitedemo. util; 


import java. util. ArrayList; 
import java. util. List; 


import android. content. Context; 

import android. database. Cursor; 

import android. database. sqlite. SQLiteDatabase; 
import cn. edu. hstc. sqlitedemo. entity.History; 


public class DBManager ( 
private DBHelper helper; 
private SQLiteDatabase db; 


public DBManager(Context context) ( 
helper = new DBHelper(context); 
// 因 为 getiiritableDatabase 内 部 调用 了 mContext. openOrCreateDatabase(mName, 0, mFactory); 
// 所 以 要 确保 context. 已 初始 化 ,可 以 把 实例 化 DBManager 的 步骤 放 在 Activity 的 onCreate 中 
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db = helper.getWritableDatabase(); 


} 

public void add(History history) { 
db. beginTransaction(); // 开 始 事务 
try { 


db. execSQL (" insert into history values (null, ?, ?, ?, ?, ?)", new Object[ ] 
(history.title, history.content, history.filePath, history.time, history.type]); 
db.setTransactionSuccessful();  // 设 置 事务 成 功 完 成 
} catch (Exception e) { 


} finally { 
db. endTransaction(); // 结 束 事务 
} 
} 
public void add(List <History> histories) { 
db. beginTransaction(); // 开 始 事务 
try f 


for (History history : histories) ( 
db. execSQL(" insert into history values(null, ?, ?, ?, ?, ?)", new Object[ ] 
{history. title, history. content, history.filePath, history. time, history.type]); 
} 
db. setTransactionSuccessful();  // 设 置 事务 成 功 完成 
} catch (Exception e) { 


} finally { 
db. endTransaction(); // 结 束 事务 
) 
) 
/ * public void addContact(List < Contact > contacts) ( 
db. beginTransaction(); // 开 始 事务 
try { 


for (Contact contact : contacts) { 
db. execSQL(" insert into contact values(null, ?, ?, ?, ?, ?, ?, ?, ?)", new 
Object[ ] (contact. name, contact. phone, contact. email, contact. company, contact. title, 
contact. address, contact. website, contact. theId]); 
} 
db.setTransactionSuccessful();  // 设 置 事务 成 功 完成 
} catch (Exception e) { 
} finally { 
db. endTransaction(); // 结 束 事务 
)*/ 


public void delete(int theId) ( 
db. beginTransaction(); 
try { 
db. execSQL("delete from history where _id=" + theId); 
db. setTransactionSuccessful(); 
} catch (Exception e) ( 
) finally ( 
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db. endTransaction(); 


public void getLastId(String table name) ( 
) 


public void deleteTableHistory() ( 
db.delete("history", null, null); 


public List «History» query(String[] type) { 

ArrayList «History» histories = new ArrayList «History»(); 

Cursor cursor = queryTheCursor(type); 

while (cursor.moveToNext()) ( 
History history = new History(); 
history. id = cursor.getInt(cursor.getColumnIndex(" id")); 
history. title = cursor.getString(cursor. getColumnIndex("title")); 
history.content - cursor.getString(cursor. getColumnIndex("content")); 
history.filePath - cursor.getString(cursor.getColumnIndex("filePath")); 
history.time = cursor.getString(cursor.getColumnIndex("time")); 
history. type = cursor.getString(cursor.getColumnIndex("type")); 
histories. add(history); 

) 

cursor.close(); 

return histories; 


public Cursor queryTheNew(String[] time) ( 
Cursor c = db.rawQuery("select * from history where time - ?", time); 
return c; 


public Cursor queryTheCursor(String[] type) ( 
Cursor c = db.rawQuery("select * from history where type =? order by id desc", type); 
return c; 


public Cursor queryTheCursorl(String[] whereStr) ( 
Cursorc = db.rawQuery("select * from history where title - ? or time - ?", whereStr); 


return c; 


public void deleteTheTable(String tableName) { 
if (hasTable(tableName)) { 
db. execSQL("delete from " * tableName); 


public void closeDB() { 
db.close(); 
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} 


public boolean hasTable( String table name) { 
boolean result = false; 
Cursor cur = null; 
try { 
String sql table = "select count( * ) as c from Sqlite_master where type = 'table' 
and name = " + table name.trim() + "'"; 
cur = db.rawQuery(sql table, null); 
if (cur.moveToNext()) ( 
int count = cur.getInt(0); 
if (count > O) ( 
result = true; 
) 
} 


cur.close(); 

) catch (Exception e) ( 
return result; 

) 


return result; 


) 


阅读 DBManager 类 源码 发 现 , 其 构造 方法 中 创建 继承 了 SQLiteOpenHelper 类 的 
DBHelper 类 对 象 ,并 调用 其 getWritableDatabase() 方 法 获得 了 一 个 SQLiteDatabase 对 象 ， 
程序 正 是 通过 调用 该 方法 创建 了 SQLite 数据 库 的 。 下 面 是 SQLiteOpenHelper 中 的 
getWritableDatabase() 的 源码 : 


public synchronized SQLiteDatabase getWritableDatabase() ( 
if (mDatabase != null && mDatabase. isOpen() && ! nDatabase. isReadOnly()) ( 
return mDatabase;  //The database is already open for business // 如 果 已 经 打开 
// 了 , 则 直接 返回 
) 
if (mIsInitializing) ( 
throw new IllegalStateException("getWritableDatabase called recursively"); 


) 
//1f we have a read - only database open, someone could be using it 
// (though they shouldn't), which would cause a lock to be held on 
//the file, and our attempts to open the database read — write would 
//fail waiting for the file lock. To prevent that, we acquire the 
//1ock on the read- only database, which shuts out other users. 
boolean success - false; 
SQLiteDatabase db = null; 
if (mDatabase != null) mDatabase. lock(); 
try { 

mIsInitializing - true; 

if (mName == null) { 

db = SQgLiteDatabase.create(null); // 以 上 没 多 大 意义 ,可 以 不 管 
} else { 
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db = mContext. openOrCreateDatabase(mName，0，mFactory) ;// 关 键 是 这 行 代码 
) 
int version = db.getVersion(); 
if (version != mNewVersion) { 
db. beginTransaction(); 
try ( 
if (version == 0)( 
onCreate(db); ”// 在 子 类 中 重 写 了 该 方法 (其 实 什么 也 没 做 ,要 想 在 
// 第 一 次 创建 时 做 一 些 操作 就 自己 在 子 类 的 方法 中 实现 , 如 创建 表 ) 
} else ( 
onUpgrade(db, version, mNewVersion); 
// 在 子 类 中 重 写 该 方法 (版 本 发 生变 化 ) 
} 
db. setVersion(mNewVersion); 
db. setTransactionSuccessful(); 
) finally ( 
db. endTransaction(); 
) 
) 
onOpen(db) ; // 在 子 类 中 重 写 该 方法 
success = true; 
return db; 
) finally ( 
mIsInitializing - false; 
if (success) ( 
if (mDatabase != null) ( 
try ( nDatabase.close(); ) catch (Exception e) ( ) 
mDatabase. unlock(); 
) 
mDatabase = db; 
) eise ( 
if (mDatabase !- null) mDatabase.unlock(); 
if (db != null) db.close(); 


) 


阅读 上 面 源码 ,可 以 发 现 ,在 getWritableDatabase() 方 法 中 有 代码 行 db — mContext. 
openOrCreateDatabase(mName. 0, mFactory) , 正 是 该 句 代 码 实 现 了 打开 或 创建 了 对 应 数据 库 
文件 名 的 数据 库 。 所 以 ,我 们 通常 是 不 用 直接 去 调用 SQLiteDatabase 的 openOrCreateDatabase 
方法 的 ,而 是 通过 SQLiteDatabase 的 一 个 帮助 类 SQLiteOpenHelper 来 实现 数据 库 的 打开 
或 创建 。 

当主 程序 中 创建 DBManager 对 象 时 ,实际 上 便 是 调用 DBManager 类 的 构造 方法 ,通过 
该 构造 方法 实现 了 数据 库 的 打开 或 创建 。 通 常 把 实例 化 DBManager 的 步骤 放 在 Activity 
的 onCreate 方法 中 。 

在 DBManager 类 中 ,通过 新 增 方法 ,实现 了 对 数据 库 的 底层 的 增 、 删 \ 改 、 查 操作 。 而 在 
业务 层面 中 ,比如 Activity 或 Fragment 中 ,只 需要 调用 实例 化 后 的 DBManager 对 象 的 这 些 
方法 , 便 可 以 实现 实际 上 的 数据 库 操 作 。 可 以 看 出 ,在 本 应 用 的 DBManager 数据 库 管 理 类 
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中 ,对 数据 库 的 增 、 删 、 改 等 非 查询 的 操作 的 方法 都 是 调用 SQLiteDatabase 的 execSQL 77 
法 来 实现 的 。 实 际 上 ,正如 上 面 介绍 SQLiteDatabase 类 常用 方法 的 表格 中 所 提 到 的 ， 
SQLiteDatabase 还 提供 了 如 insert、update、delete、query 等 方法 来 实现 操作 数据 库 ,完全 可 
以 不 必 通 过 执行 SQL 语句 来 完成 ,但 Android 考虑 到 部 分 开发 者 对 SQL 语法 的 不 熟悉 , 故 
提供 了 这 些 方法 帮助 开发 者 以 更 简单 的 方式 来 操作 数据 库 表 的 数据 。 

可 以 发 现 ,DBManager 类 中 查询 数据 库 表 数据 的 基础 方法 都 是 返回 一 个 Cursor 对 象 ， 
Android 中 的 Cursor 类 似 于 JDBC 的 ResultSet,Cursor 同样 提供 了 如 表 8. 4 所 示 的 方法 来 
移动 查询 结果 的 记录 指针 。 

表 8.4 移动 查询 结果 的 记录 指针 的 方法 





方 法 名 方法 描述 
move(int offset) 将 记录 指针 向 上 或 向 下 移动 指定 的 行 数 。offset 为 正 数 就 是 向 下 
移动 ,为 负数 就 是 向 上 移动 

boolean moveToFirst() 将 记录 指针 移动 到 第 一 行 ,如 果 成 功 则 返回 true 

boolean moveToLast() 将 记录 指针 移动 到 最 后 一 行 ,如 果 成 功 则 返回 true 

boolean moveToNextO 将 记录 指针 移动 到 下 一 行 ,如 果 成 功 则 返回 true 

boolean moveToPosition(int position) ”将 记录 指针 移动 到 指定 的 行 ,如 果 成 功 则 返回 true 

boolean moveToPrevious() 将 记录 指针 移动 到 上 一 行 , 如 果 成 功 则 返回 true 


一 旦 将 记录 指针 移动 到 指定 行 之 后 , 接 下 来 就 可 以 调用 Cursor 的 getXxx() 方 法 来 获 
取 该 行 的 指定 列 的 数据 。 


6.4 本 章 小 结 


本 章 主要 介绍 了 Android 的 数据 存储 以 及 文件 的 读 写 。 利 用 SharedPreferences 可 以 
非常 方便 地 读 、 写 应 用 程序 的 参数 .选项 。Android 还 提供 了 openFileOutput 和 
openFileInput 两 个 便捷 的 方法 来 实现 文件 的 IO 操作 。 除 此 之 外 ,Android 操作 SQLite 数 
据 库 也 是 本 章 的 重点 ,读者 需要 学 习 如 何 利 用 Android 提供 的 大 量 方便 的 工具 类 来 访问 
SQLite 数据 库 。 
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Android 官方 指出 的 数据 存储 方式 总 共有 五 种 .分别 是 Shared Preferences、 网 络 存储 、 
文件 存储 、 外 储存 储 、SQLite。 但 是 一 般 这 些 存储 都 只 是 在 单独 的 一 个 应 用 程序 之 中 达到 
一 个 数据 的 共享 ,因为 在 不 同 应 用 之 间 共 享 数据 时 使 用 这 种 方式 显得 太 杂 乱 了 ,不 利于 操 
作 , 但 用 户 依然 可 能 选择 这 么 做 。 因 此 ,为 了 适应 一 个 应 用 程序 操作 另 一 个 应 用 程序 的 一 些 
数据 ,例如 ,需要 操作 系统 里 的 媒体 库 、 通 讯 录 等 ,这 时 就 可 能 通过 ContentProvider 来 满足 
人 们 的 需求 了 。 

ContentProvider 提供 了 在 应 用 程序 之 间 共 享 数据 的 一 种 机 制 ,是 不 同 应 用 程序 之 间 数 
据 交换 的 标准 API, 当 一 个 应 用 程序 需要 把 自己 的 数据 暴露 给 其 他 程序 使 用 时 ,该 应 用 程序 
就 可 通过 提供 ContentProvider 来 实现 ,其 他 应 用 程序 就 可 通过 ContentResolver 来 操作 
ContentProvider 暴露 的 数据 。 


8.1 实现 通过 ContentProvider 共享 数据 的 应 用 


本 节 通 过 实现 一 个 用 于 对 图 书 进行 管理 的 APP, 但 其 并 没有 直接 进行 数据 库 操作 ,而 
是 提供 一 个 ContentProvider, 共 享 数据 ,然后 再 实现 另 一 个 APP, 通 过 ContentResolver 来 
操作 第 一 个 应 用 所 暴露 的 数据 。 

新 建 一 个 图 书 实体 类 BookBean ,该 实体 类 对 应 了 数据 库 表 book ,源码 如 下 : 


package cn. edu. hstc. contentproviderdemo. entity; 


public class BookBean ( 
public int id; 
public String number; 
public String name; 
public String press; 


public BookBean() ( 
) 


public BookBean(String number, String name, String press) ( 
this.number = number; 
this.name = name; 
this.press = press; 
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public BookBean(int id, String number, String name, String press) { 


this. id - id; 
this.number = number; 
this.name - name; 


this.press - press; 


代码 文件 : codesV09 V9. 1NContentProviderDemoVcnVeduMhstc Vut ilVBookBean. java 


由 于 需要 操作 SQLite 数据 库 , 还 需要 两 个 数据 库 管理 与 操作 的 工具 类 ,这 与 第 8 章 中 
实现 简易 旅游 记录 仪 APP 时 所 用 到 的 数据 库 工 具 类 类 似 , 并 且 SQLite 的 知识 并 不 是 本 章 
的 重点 ,在 此 不 给 出 源码 ,读者 可 以 通过 本 书 所 附带 的 源码 获得 。 实 现 本 应 用 需要 用 到 另 一 
个 常量 工具 类 ,源码 如 下 : 


package cn. edu. hstc. contentproviderdemo. util; 


import android. net. Uri; 


import android. provider. BaseColumns; 


public class Constant ( 
// 5€ X. ContentProvider 的 Authority 
public static final String AUTHORITY = "cn. edu. hstc. providers. bookprovider" ; 


// 定 义 一 个 静态 内 部 类 
public static final class Book implements BaseColumns { 


"/books" 


book") ; 
) 


// 定 义 ContentProvider 所 允许 操作 的 4 个 数据 列 

public final static String ID = " id"; 

public final static String NUMBER - "number"; 

public final static String NAME - "name"; 

public final static String PRESS - "press"; 

//5€ X. ContentProvider 提供 服务 的 两 个 Uri 

public final static Uri BOOKS CONTENT URI = Uri.parse("content://" + AUTHORITY + 
) 

public final static Uri BOOK CONTENT URI = Uri.parse("content://" + AUTHORITY + "/ 


代码 文件 : codes\09\9. 1NContentProviderDemoVcnVeduMhstc Vut ilVConstant. java 


接着 ,需要 实现 本 应 用 的 重点 , 即 实现 能 共享 数据 的 ContentProvider. iz; ContentProvider 


的 源码 如 下 : 


package cn. edu. hstc. contentproviderdemo. util; 


import android. content. ContentProvider; 
import android. content. ContentUris; 
import android. content. ContentValues; 
import android. content. UriMatcher; 
import android. database. Cursor; 
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import android. net. Uri; 


public class BookProvider extends ContentProvider ( 
private static UriMatcher matcher = new UriMatcher(UriMatcher.NO MATCH); 
private static final int BOOKS - 1; 
private static final int BOOK = 2; 
private DBManager dbManager; 
static ( 
// 为 UriMatcher 注册 两 个 Uri 
matcher.addURI(Constant. AUTHORITY, "books", BOOKS); 
matcher. addURI (Constant. AUTHORITY, "book/ it", BOOK); 


/*x 
* 第 一 次 调用 该 ContentProvider 时 ,系统 先 创建 BookProvider 对 象 ,并 回调 该 方法 * / 
(QOverride 
public boolean onCreate() ( 
dbManager = new DBManager(this.getContext()); 
return false; 


@Override 
public String getType(Uri uri) { 
switch (matcher. match(uri)) { 
// 如 果 操 作 的 数据 是 多 项 记录 
Case BOOKS: 
return "vnd. android. cursor. dir/cn. edu. hstc. providers. book" ; 
// 如 果 操 作 的 数据 是 单项 记录 
case BOOK: 
return "vnd. android. cursor. item/cn. edu. hstc. providers. book" ; 
default: 
throw new IllegalArgumentException(" Æ% Uri:" + uri); 


(QOverride 
public Uri insert(Uri uri, ContentValues values) ( 
// 插 入 数据 ,返回 行 ID 
long rowId = dbManager.insert(Constant.Book. ID, values); 
// 如 果 插 入 成 功 返 回 uri 
if (rowId> 0) { 
// 在 已 有 的 Uri 的 后 面 追加 ID 数 据 
Uri wordUri = ContentUris.withAppendedId(uri, rowId); 
// 通 知 数据 已 经 改变 
getContext().getContentResolver().notifyChange(wordUri, null); 
return wordUri; 
) 


return null; 


(QOverride 
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public int delete(Uri uri, String selection, String[] selectionArgs) { 
// 记 录 所 删除 的 记录 数 
int num = 0; 
// 对 于 uri 进行 匹配 。 
Switch (matcher.match(uri)) { 
case BOOKS: 
num = dbManager.delete(selection, selectionArgs); 
break; 
case BOOK: 
// 解 析出 所 需要 删除 的 记录 ID 
long id = ContentUris. parseId(uri); 
String where = Constant.Book. ID + "-" + id; 
// 如 果 原 来 的 where 子 句 存在 ,拼接 where 子 句 
if (selection != null && ! selection.equals("")) { 
where = where + " and" + selection; 
) 
num = dbManager.delete(where, selectionArgs); 
break; 
default: 
throw new IllegalArgumentException(" Kd Uri:" + uri); 
) 
// 通 知 数据 已 经 改变 
getContext().getContentResolver().notifyChange(uri, null); 
return num; 


(QOverride 
public int update (Uri uri, ContentValues values, String selection, String [ ] 
selectionArgs) ( 
// 记 录 所 修改 的 记录 数 
int num = 0; 
Switch (matcher.match(uri)) { 
case BOOKS: 
num = dbManager.update(values, selection, selectionhrgs); 
break; 
case BOOK: 
// 解 析出 想 修改 的 记录 ID 
long id = ContentUris.parseld(uri); 
String where = Constant.Book. ID + " = " + "?"; 
// 如 果 原 来 的 where 子 句 存在 ,拼接 where FAJ 
if (selection != null && ! selection.equals("")) { 
where = where + " and" + selection; 


) 
num = dbManager.update(values, where, selectionArgs); 
break; 
default: 
throw new IllegalArgumentException(" X% Uri:" + uri); 
} 
// 通 知 数据 已 经 改变 


getContext().getContentResolver().notifyChange(uri, null); 
return num; 
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} 


@Override 
public Cursor query (Uri uri, String [ ] projection, String selection, String [ ] 
selectionArgs, String sortOrder) ( 
switch (matcher.match(uri)) { 
case BOOKS: 
// 执 行 查询 
return dbManager. query(projection, selection, selectionArgs, sortOrder); 
case BOOK: 
// 解 析出 想 查询 的 记录 ID 
long id = ContentUris.parseId(uri); 
String where = Constant.Book. ID + "=" + id; 
// 如 果 原 来 的 where 子 句 存在 ,拼接 where FAJ 
if (selection != null && !"". equals(selection)) { 
where = where + " and" + selection; 


) 

return dbManager.query(projection, where, selectionArgs, sortOrder); 
default: 

throw new IllegalArgumentException(" Kk ^j Uri:" + uri); 
) 


代码 文件 : codesV09 V9. 1NContentProviderDemoVcnVeduMhstc Vut ilVBookProvider. java 


该 应 用 并 没有 实现 自身 操作 SQLite 数据 库 , 故 没有 提供 让 用 户 操作 图 书 数据 的 交互 界 
面 ,启动 该 应 用 完成 的 是 新 建 数据 库 book. db 并 建立 数据 库 表 book, 同 时 注册 了 
BookProvider。 只 要 启动 一 次 该 应 用 ,就 会 将 数据 通过 BookProvider 暴露 给 其 他 APP, 其 
他 APP 便 可 操作 其 数据 了 。 

这 里 并 没有 通过 自身 去 操作 SQLite 数据 库 ,所 以 并 不 用 提供 与 用 户 操作 交互 的 界面 ， 
而 是 在 启动 界面 中 提示 用 户 数据 库 表 已 存在 以 及 ContentProvider 已 存在 就 可 以 了 。 此 部 
分 的 实现 所 涉及 的 布局 以 及 Activity 源码 非常 简单 , 故 不 贴 出 源码 ,读者 可 以 通过 本 书 附带 
源码 获得 。 

接 下 来 ,需要 实现 另 一 个 APP, 即 利用 ContentResolver 操作 刚才 已 经 实现 的 APP iÑ 
过 ContentProvider 暴露 的 数据 。 

由 于 现在 要 实现 的 这 个 应 用 是 需要 操作 数据 的 ,所 以 需要 提供 与 用 户 交 互 的 界面 ,该 界 
面 提供 展示 图 书 编号 .图书 名 称 、 出 版 社 的 文本 输入 框 ,以 及 对 应 增 、 删 \ 改 、 查 四 个 操作 的 
Button 按钮 。 该 界面 布局 比较 简单 ,读者 可 通过 学 习 本 书 附带 源码 获得 。 

实现 该 应 用 还 需要 提供 一 个 与 暴露 数据 的 应 用 一 样 的 常量 类 Constant, 同样 定义 了 
ContentProvider 所 允许 操作 的 四 个 数据 列 ,以 及 ContentProvider 提供 服务 的 两 个 Uri, 

接 下 来 所 要 介绍 的 与 用 户 交 互 的 各 个 按钮 的 核心 功能 代码 将 是 需要 重点 掌握 的 。 该 交 
T. Activity 的 源码 如 下 : 


package cn. edu. hstc. contentresolverdemo. activity; 


import android. app. Activity; 


第 9 章 ”使 用 ContentProvider 263 


import android. content. ContentResolver; 
import android. content. ContentUris; 
import android. content. ContentValues; 
import android. database. Cursor; 

import android. os. Bundle; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. Button; 

import android. widget. EditText; 

import android. widget. Toast; 

import cn. edu. hstc. contentresolverdemo. util.Constant; 


public class MainActivity extends Activity implements OnClickListener ( 
ContentResolver contentResolver; 
private Button insertBtn, deleteBtn, updateBtn, queryBtn; 
private int id; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout.activity main); 
// 获 取 系 统 的 ContentResolver 对 象 
contentResolver = getContentResolver(); 
initView(); 


private void initView() ( 
insertBtn - (Button) findViewById(R. id.btn add); 
insertBtn. setOnClickListener(this); 
deleteBtn = (Button) findViewById(R. id. btn delete); 
deleteBtn. setOnClickListener(this); 
updateBtn = (Button) findViewById(R. id.btn update); 
updateBtn. setOnClickListener(this); 
queryBtn - (Button) findViewById(R. id.btn query); 
queryBtn. setOnClickListener(this); 


(QOverride 
public void onClick(View v) ( 
switch (v.getId()) ( 
case R. id. btn add: 
insertBook(); 
break; 
case R. id. btn delete: 
deleteBook(); 
break; 
case R. id. btn update: 
updateBook(); 
break; 
case R. id. btn query: 
queryBook(); 
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break; 
default: 
break; 


private void insertBook() ( 
String number = ((EditText) findViewById(R. id.book number)).getText().toString(); 
String name - ((EditText) findViewById(R. id. book name)).getText().toString(); 
String press = ((EditText) findViewById(R. id. book press)).getText().toString(); 
// 插 入 图 书 
ContentValues values = new ContentValues(); 
values. put (Constant. Book. NUMBER, number); 
values. put(Constant. Book. NAME, name); 
values. put(Constant.Book. PRESS, press); 
contentResolver. insert(Constant. Book. BOOK CONTENT URI, values); 
// 显 示 提 示 信 息 
Toast.makeText(Mainhctivity.this，" 添 加 图 书 成 功 !"，20000). show() ; 


private void deleteBook() ( 
contentResolver. delete (Constant. Book. BOOKS CONTENT URI, " id = ?", new String[] 
(String. valueOf( id)]); 
((EditText) findViewById(R. id.book number)).setText(""); 
((EditText) findViewById(R. id.book name)).setText(""); 
((EditText) findViewById(R. id.book press)).setText(""); 
Toast.makeText(MainActivity.this, "删除 图 书 成 功 !"，20000). show() ; 


private void updateBook() ( 

String number = ((EditText) findViewById(R. id. book number)).getText().toString(); 

String name = ((EditText) findViewById(R. id. book name)).getText().toString(); 

String press = ((EditText) findViewById(R. id. book press)).getText().toString(); 

// 修 改 图 书 

ContentValues values = new ContentValues(); 

values.put(Constant. Book. NUMBER, number); 

values. put(Constant.Book. NAME, name); 

values.put(Constant.Book.PRESS, press); 

//contentResolver. update(Constant. Book. BOOKS CONTENT URI, values, " id = ?", new 
String[](String.valueOf( id)]); 

contentResolver. update( ContentUris. withAppendedId(Constant. Book. BOOK CONTENT URI, 
.id), values, null, new String[](String.valueOf( id)]); 

Toast.makeText(MainActivity.this, "更 新 图 书 成 功 !",，20000). show() ; 


} 

private void queryBook() { 
// 获 取 用 户 输入 
String number = ((EditText) findViewById(R. id. book number)).getText().toString(); 
// 执 行 查询 


Cursor cursor = contentResolver. query (Constant. Book. BOOKS CONTENT URI, null, 
"number like ?", new String[](" $" + number + "%"}, null); 
while (cursor.moveToNext()) ( 
.id = cursor.getInt(0); 
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((EditText) findViewById(R. id. book name)). setText(cursor. getString(2)); 
((EditText) findViewById(R. id. book_press)). setText(cursor. getString(3)); 


代码 文件 : codes\09\9. 1\ContentResolverDemo\cn\edu\hstc\activity\MainActivity. java 


将 ContentProviderDemo 项 目 部 署 在 Android 模拟 器 上 并 启动 应 用 ,可 看 到 如 图 9. 1 
所 示 界 面 。 

接着 ,将 ContentResolverDemo M A RAE Android 模拟 器 上 并 启动 应 用 ,在 页 面 中 输 
入 图 书 编号 .图书 名 称 以 及 出 版 社 名 称 , 单 击 * 增 ?按钮 ,将 会 为 ContentProviderDemo M H 
中 的 book. db 数据 库 中 的 book 表 添 加 一 行 数据 ,如 图 9. 2 所 示 。 


BM E 3:00 BM E 3:19 


数据 库 表 已 存在 ! ContentProvider 已 注册 ! Cm 
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图 9.1 启动 应 用 ,暴露 数据 给 其 他 应 用 图 9.2 新 增 图 书信 息 


将 图 书 名 称 修改 为 (中 国 经 济 论 》, 单 击 * 改 "按钮 ,出现 如 图 9. 3 所 示 效 果 。 

将 图 书 名 称 以 及 出 版 社 的 输入 框 留 空 ,只 剩 下 图 书 编号 写 入 “B001”, 然 后 单 击 “ 查 ” 按 
钮 ,将 会 看 到 与 修改 图 书信 息 时 一 样 的 界面 ,这 是 因为 根据 编号 查 出 了 刚才 的 图 书信 息 , 然 
后 , 当 单 击 “ 删 "按钮 时 ,将 会 提示 用 户 删除 图 书 成 功 ,再 次 以 B001 的 编号 去 查找 图 书 ,已 经 
查 不 到 任何 信息 了 。 

至 此 , 自 定义 ContentProvider 暴露 自身 数据 以 及 通过 ContentResolver 操作 其 他 应 用 
的 数据 的 开发 流程 以 及 项 目 演 示 已 全 部 介绍 完毕 。 接 下 来 将 会 对 以 上 的 开发 程序 进行 章 
析 ,帮助 读者 更 进一步 地 理解 ContentProvider 以 及 ContentResolver 两 个 组 件 。 
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8.2 通过 分 析 实 例 认 识 ContentProvider 


在 9.1 节 中 ,已 经 在 应 用 中 实现 了 自己 的 ContentProvider 组 件 ,成 功 将 数据 暴露 出 来 ， 
并 且 , 实 现 了 另 一 个 应 用 程序 。 即 通过 ContentResolver 对 暴露 接口 的 应 用 进行 数据 管理 
操作 。 通 过 分 析 ContentProviderDemo 的 程序 ,可 以 发 现 ,实现 自 定义 ContentProvider 其 
实 非常 简单 ,只 需 按照 以 下 两 个 步骤 去 操作 即 可 : 

(D 定义 自己 的 ContentProvider 类 ,该 类 继承 自 Android 提供 的 ContentProvider 
基 类 。 

© 向 Android 系统 注册 开发 好 的 ContentProvider 组 件 , 即 在 全 局 配置 文件 
AndroidManifest. xml 中 声明 该 ContentProvider, 同 时 为 其 绑 定 一 个 authorities 属性 ,相当 
于 对 外 开放 了 一 个 访问 接口 地 址 。 

在 AndroidManifest. xml 注册 ContentProvider 的 方式 为 在 < application/> 元 素 中 添加 
一 个 < provider/> 子 元 素 。 代 码 片段 如 下 所 示 : 

<! -- 注册 一 个 ContentProvider -一 > 

< provider 

android:name = "cn. edu. hstc. contentproviderdemo. util. BookProvider" 


android:authorities = "cn. edu. hstc. providers. bookprovider" /> 


从 BookProvider 的 开发 实现 过 程 中 ,可 以 看 出 ,BookProvider 是 通过 实现 其 基 类 中 的 
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以 下 几 个 方法 来 实现 将 程序 内 部 数据 暴露 出 来 的 。 这 些 方法 包括 了 程序 对 数据 的 CRUD 
操作 。 通 过 阅读 BookProvider 类 的 源码 ,可 以 总 结 得 到 表 9. 1. 


表 9.1 ContentProvider 需要 实现 的 方法 


方 法 名 描 æ 

当 其 他 程序 第 一 次 访问 ContentProvider 时 ,该 
方法 在 ContentProvider 创建 后 会 被 立即 调用 
public Uri insert(Uri uri, ContentValues values) 根据 Uri 插入 values 对 应 的 数据 

public int delete ( Uri uri, String selection. String [ ] 





public void onCreate() 








根据 Uri 删除 select 条 件 所 匹配 的 全 部 记录 


selectionArgs) 





public int update(Uri uri, ContentValues values, String 根据 Uri 修改 select 条 件 所 匹配 的 全 部 记录 
根据 Uri 查询 出 select 条 件 所 匹配 的 全 部 记 
录 , 其 中 projection 就 是 一 个 列 名 列表 ,表示 只 
选择 指定 的 数据 列 

该 方法 用 于 返回 当前 Uri 所 代表 的 数据 的 
MIME 类 型 。 如 果 该 Uri 对 应 数据 可 能 包含 多 
条 记录 ,那么 MIME 类 型 字符 串 应 该 以 vnd. 
android. cursor. dir/JF 3k; 如 果 该 Uri 对 应 的 数 
据 只 包含 一 条 记录 ,那么 返回 的 MIME 类 型 字 
符 串 应 该 以 vnd. android. cursor. item/ 开 头 


selection, String[ ] selectionArgs) 





public Cursor query (Uri uri, String[ ] projection, String 


selection, String ] selectionArgs. String sortOrder) ( 





public String getType(Uri uri) 





通过 表 9. 1 中 的 介绍 中 不 难 发 现 , 对 于 ContentProvider 而 言 ,Uri 是 一 个 非常 重要 的 
概念 。 实 际 上 ,ContentProvider 也 是 通过 该 Uri 向 其 他 应 用 暴露 了 自己 的 数据 操作 接口 。 
这 个 模式 就 像 通 过 网 址 去 访问 网 站 一 样 。 下 面 将 对 Uri 这 个 概念 进行 介绍 。 

打开 ContentProviderDemo 应 用 源码 中 的 Constant 类 ,发现 其 中 定义 了 两 个 可 以 为 外 
界 提 供 服务 的 Uri, 这 两 个 Uri 是 通过 Android 提供 的 Uri 工具 类 中 的 parse() 静 态 方 法 将 
字符 串 转换 成 一 个 真正 的 Uri 地 址 后 。 例 如 ,Constant 类 中 的 以 下 代码 片段 : 

// 定 义 ContentProvider 提供 服务 的 两 个 Uri 

public final static Uri BOOKS CONTENT URI = Uri.parse("content://" + AUTHORITY + "/books"); 

public final static Uri BOOK CONTENT URI = Uri.parse("content://" + AUTHORITY + "/book"); 

阅读 上 下 文 代码 ,不 难 发 现 ,这 两 个 Uri 地 址 所 对 应 的 字符 串 形式 如 下 : 
(D content; / /cn. edu. hstc. providers. bookprovider/book 
(2) content ; //cn. edu. hste. providers. bookprovider/books 
对 于 以 上 的 两 个 Uri 地 址 ,可 以 分 成 以 下 三 个 部 分 : 
名 content:// 一 一 这 个 部 分 是 Android 系统 规定 的 ,是 固定 的 .相当 于 一 种 协议 ; 
Ææ cn. edu. hstc. providers. bookprovider 一 一 这 个 部 分 就 是 AndroidManifest. xml 配置 
文件 中 注册 ContentProvider 时 所 绑 定 的 authorities 属性 的 值 。 系 统 就 是 通过 这 个 
部 分 来 找到 操作 哪个 ContentProvider; 

着 books 一 一 资源 部 分 (数据 部 分 ) ,这 个 部 分 是 需要 动态 改变 的 ,因为 访问 者 需要 访问 
到 不 同 资 源 。 

例如 ,如 果 想 访问 book 数据 中 _id 为 1 的 记录 , 则 可 以 通过 content://cn. edu. hste. 
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providers. bookprovider/book/1 这 样 的 Uri 来 访问 。 

如 果 想 访问 book 数据 中 _id 为 1 的 记录 的 number 字段 , 则 可 以 通过 content://en. 
edu. hstc. providers. bookprovider/book/1/number 这 样 的 Uri 来 访问 。 

同 理 ,content://cn. edu. hstc. providers. bookprovider/books 访问 的 就 是 book 表 的 全 
部 数据 。 

实际 上 ,使 用 ContentProvider 所 暴露 的 数据 并 不 是 只 来 源 于 数据 库 , 有 时 ,XML 文件 
或 网 络 等 其 他 数据 存储 方式 也 能 成 为 数据 的 来 源 ,此 时 ,假如 应 用 需要 通过 Uri 访问 一 份 
XML 文件 中 的 book 父 节点 下 的 number 子 节点 ,那么 该 Uri 内 容 可 以 为 : content: //cn. 
edu. hstc. providers. bookprovider/books/number/ , 

至 此 ,相信 读者 已 经 对 应 用 开发 中 所 涉及 的 Uri 有 了 一 定 的 认 知 , 接 下 来 将 通过 对 
ContentProviderDemo 中 所 实现 的 BookProvider 类 进行 详细 的 介绍 ,来 帮助 读者 更 进一步 
掌握 如 何 实现 自 定义 的 ContentProvider 组 件 。 

试想 一 下 ,现在 用 户 正 在 实现 ContentProvider 类 中 的 delete 方 法 ,从 业务 需求 上 来 说 ， 
该 方法 非常 可 能 会 涉及 操作 删除 全 部 数据 或 者 符合 数据 库 表 中 对 应 主键 _id 的 单条 数据 ， 
那么 同一 个 方法 中 是 如 何 判断 其 他 应 用 所 传 过 来 的 Uri 参数 是 要 操作 全 部 数据 还 是 单条 数 
据 呢 ? 

为 了 解决 上 述 问题 ,Android 提供 了 UriMatcher 工具 类 。 该 工具 类 主要 提供 如 下 两 个 
方法 : 

(D void addURICString authority. String path. int code) 一 一 该 方法 实现 向 UriMatcher 对 
象 注册 Uri。 参 数 authority 以 及 参数 path 组 合成 为 一 个 Uri, 而 code 参数 代表 了 该 Uri 所 
对 应 的 标识 码 。 

@ intmatch(Uri uri) 一 一 该 方法 返回 指定 Uri 所 对 应 的 标识 码 , 即 addURI 方法 中 所 
传人 的 code 参数 。 如 果 在 已 经 注册 过 Uri 的 UriMatcher 对 象 中 找 不 到 匹配 的 标识 码 , 则 
返回 一 1。 

有 了 UriMatcher 工具 类 ,程序 便 可 以 提前 注册 好 所 有 可 能 会 出 现 的 Uri 形式 ,然后 在 
具体 的 CRUD 实现 方法 中 ,通过 match(Uri uri) 方 法 的 返回 值 判断 出 该 Uri 形式 ,然后 实现 
不 同 的 操作 数据 的 代码 。 

那么 ,如 何 创 建 一 个 UriMatcher 实例 呢 ? 带 着 这 个 疑问 阅读 一 下 BookProvider 类 的 
代码 ,会 发 现 如 下 代码 片段 : 

private static UriMatcher matcher = new UriMatcher(UriMatcher. NO_MATCH); 

private static final int BOOKS - 1; 

private static final int BOOK - 2; 

private DBManager dbManager; 

static ( 

// 为 UriMatcher 注册 两 个 Uri 
matcher. addURI(Constant. AUTHORITY, "books", BOOKS); 
matcher. addURI(Constant. AUTHORITY, "book/ £t", BOOK); 

) 

第 一 行 代码 中 , 通过 new UriMatcher CUriMatcher. NO. MATCH) 创建 了 一 个 
UriMatcher 实例 ,然后 通过 静态 代码 块 中 的 代码 ,为 该 UriMatcher 实例 注册 了 两 个 Uri 地 
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Ab. HB addURI 方法 中 第 一 个 参数 和 第 二 个 参数 组 合成 一 个 Uri 地 址 ,第 三 个 参数 为 该 Uri 
地 址 所 对 应 的 标识 码 。 那 么 ,可 以 得 出 cn. edu. hste. providers. bookprovider/books 所 对 应 
的 标识 码 为 1 ,cn. edu. hste. providers. bookprovider/book/# 所 对 应 的 标识 码 为 2。 

这 里 需要 注意 的 是 , # 是 作为 通配符 存在 的 ,这 就 意味 着 , cn. edu. hste. providers. 
bookprovider/book/ 井 中 的 井 可 以 由 任意 字符 所 代替 ,也 就 是 说 ,matcher. match( Uri. parse 
C"cn. edu. hstc. providers. bookprovider/book/1")) fll matcher. match(Uri. parse("cn. edu. 
hste. providers. bookprovider/book/2")) 所 返回 的 标识 码 同 为 2, 依 此 类 推 。 

阅读 BookProvider 类 中 的 delete 方法 代码 ,发 现 其 正 是 通过 UriMatcher 对 象 的 match 
Uri uri) 方 法 来 获得 其 他 应 用 所 传人 的 Uri 地 址 的 返回 值 , 根 据 该 返回 值 来 判断 该 Uri 地 
址 的 形式 并 执行 不 同 的 代码 片段 。 

细心 的 读者 也 许 已 经 发 现 了 ,delete 方法 中 还 涉及 一 个 ContentUris 的 工具 类 。 该 工具 
类 的 静态 方法 parseld Uri uri) 返 回 了 一 个 long 类 型 的 值 。 那 么 这 个 ContentUris 工具 类 
又 是 干什么 的 呢 ? 

实际 上 ,ContentUris 是 一 个 操作 Uri 字符 串 的 工具 类 , 它 提供 了 如 下 两 个 方法 : 

(D Uri withAppendedId(Uri uri. long rowId) 一 一 用 于 为 一 个 Uri 地 址 加 上 ID 部 分 。 
例如 Uri uri = ContentUris. withAppendedId (Uri. parse € " cn. edu. hste. providers. 
bookprovider/book") ,1) 所 生成 的 新 的 Uri 地 址 为 cn. edu. hste. providers. bookprovider/ 
book/1; 

© long parseldC Uri uri) 一 一 用 于 从 传人 的 Uri 参数 中 解析 出 指定 的 ID 值 。 例 如 long 
id— ContentUris. parseld ( Uri. parse C" cn. edu. hstc. providers. bookprovider/book/1")); 
所 返回 的 id 值 为 1 。 

有 了 这 个 ContentUris 工具 类 , 便 可 以 在 delete 方法 中 通过 该 工具 类 解析 出 其 他 应 用 
所 传 入 的 Uri 地 址 所 带 的 ID 值 . 然 后 根据 该 ID 值 拼 接 相 应 的 数据 库 语 句 ,删除 指定 主键 所 
对 应 的 单条 数据 。 读 者 可 以 通过 阅读 BookProvider 类 中 的 delete 方法 体会 上 述 流程 。 

至 此 ,开发 自 定 义 ContentProvider 组 件 的 基本 知识 已 全 部 介绍 完毕 ,掌握 以 上 知识 点 ， 
读者 便 可 以 迅速 开发 自己 的 ContentProvider 来 暴露 应 用 的 数据 , 供 其 他 应 用 访问 。 那 么 ， 
说 到 其 他 应 用 对 ContentProviderDemo 所 暴露 出 来 的 图 书 数据 的 访问 ,这 涉及 了 9.1 节 中 
所 实现 的 另 一 个 应 用 程序 一 一 ContentResolverDemo。 该 应 用 通过 ContentResolver 来 操 
f£ BookProvider 所 暴露 的 数据 。 接 下 来 将 对 ContentResolverDemo 中 的 源码 进行 剖析 ,以 
帮助 用 户 更 好 地 掌握 ContentResolver 的 操作 方法 。 

上 面 已 经 讲 过 ,其 他 应 用 需要 使 用 ContentResolver 才能 操作 ContentProvider 暴露 的 
数据 。 阅 读 ContentResolverDemo 项 目的 MainActivity 类 的 源码 可 以 发 现 , 创建 
ContentResolver 实例 是 通过 Context 提供 的 getContentResolver() 方 法 来 获取 的 。 一 旦 程 
序 获得 ContentResolver 对 象 之 后 , 便 可 以 调用 其 CRUD 四 个 方法 来 操作 ContentProvider 
暴露 的 数据 。ContentResolver 提供 的 四 个 方法 如 表 9. 2 所 示 。 

一 般 来 说 ,ContentProvider 是 单 例 模式 的 , 当 多 个 应 用 程序 通过 ContentResolver 来 操 
作 ContentProvider 提供 的 数据 时 ,ContentResolver 调用 的 数据 操作 将 会 委托 给 同一 个 
ContentProvider 处 理 。 
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表 9.2  ContentResolver 所 支持 的 方法 

















方法 名 描 3k 

: x 向 Uri 对 应 的 ContentProvider 中 插入 values 对 应 的 
insertCUri uri，ContentValues values) 

数据 

k Uri 对 应 的 ContentProvid here 提交 匹配 

| 

的 数据 
update(Uri uri, ContentValues values , String | 更 新 Uri 对 应 的 ContentProvider 中 where 提交 匹配 
where, String[ ]selectionArgs) 的 数据 
query (uri，projection，selection，selectionArgs，| 查询 Uri 对 应 的 ContentProvider 中 where 提交 匹配 
sortOrder) 的 数据 


可 以 根据 表 9. 2 中 ContentResolver 的 基本 知识 ,阅读 ContentResolverDemo 的 
MainActivity 类 的 源码 ,加深 对 ContentResolver 操作 ContentProvider 的 理解 。 


8.3 访问 通讯 录 中 的 联系 人 和 添加 联系 人 


上 面 已 经 介绍 了 如 何 开 发 自己 的 ContentProvider 以 及 使 用 ContentResolver 操作 
ContentProvider 所 暴露 的 数据 。 实 际 上 ,Android 系统 自身 所 带 的 应 用 已 经 暴露 了 大 量 的 
ContentProvider, 人 允许 开发 者 来 操作 这 些 ContentProvider 所 暴露 的 数据 。 

回顾 上 面 的 介绍 ,可 以 知道 ,使 用 ContentResolver 操作 数据 的 步骤 如 下 : 

@ 调用 Context 的 getContentResolver() 获 取 ContentResolver 的 对 象 ; 

© 调用 ContentResolver 的 insert、delete、update、query 方法 操作 数据 。 

为 了 操作 系统 基本 的 ContentProvider, 需 要 了 解 ContentProvider 所 对 应 的 Uri。 这 里 ,以 
访问 系统 通讯 录 为 例 ,介绍 如 何 使 用 ContentResolver 操作 系统 提供 的 ContentProvider。 

Android 系统 提供 了 Contacts 应 用 程序 来 管理 手机 联系 人 ,而 且 该 应 用 程序 还 对 外 提 
供 了 ContentProvider, 所 以 开发 者 可 以 开发 自己 的 应 用 程序 ,通过 ContentResolver 来 管理 
联系 人 数据 。 

Android 系统 对 联系 人 管理 暴露 的 ContentProvider 的 Uri 如 下 : 

t ContactsContract. Contacts, CONTENT_URI 一 一 管理 联系 人 的 Uri; 

名 ContactsContract. CommonDataKinds. Phone. CONTENT_URI 一 一 管理 联系 人 的 

电话 的 Uri; 

 ContactsContract. CommonDataKinds. Email. CONTENT_URI 一 一 管理 联系 人 的 

E-mail 的 Uri。 

知道 了 以 上 手机 联系 人 应 用 的 ContentProvider 的 Uri 后 ,就 可 以 在 应 用 程序 中 使 用 
ContentResolver 来 管理 联系 人 的 数据 了 。 下 面 通过 实现 一 个 APP 来 实际 操作 联系 人 的 
数据 。 

新 建 一 个 Android Application Project, 命 名 为 ContactResolverDemo ,填写 相关 必要 的 
信息 ,完成 创建 项 目 。 该 应 用 的 需求 为 : 在 启动 界面 告知 用 户 按 手机 Menu 键 可 以 查询 和 
添加 联系 人 ,然后 通过 创建 Android OptionsMenu 创建 两 个 菜单 项 ,其 中 一 个 用 于 弹出 一 
个 对 话 框 供用 户 填 写 手机 联系 人 的 姓名 、 手 机 号 码 、 邮 件 地 址 三 个 属性 ,然后 单 击 对话 框 “ 确 
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定 ” 按 钮 完成 联系 人 的 添加 ; 另 一 个 菜单 项 用 来 供用 户 单 击 查询 手机 联系 人 列表 ,然后 显示 
在 一 个 ExpandableListView 界面 组 件 中 。 这 两 个 功能 都 需要 操作 手机 自 带 的 联系 人 应 用 
所 暴露 的 ContentProvider。 

由 于 启动 界面 的 布局 非常 简单 ,在 此 不 列 出 源码 。 当 用 户 单 击 添加 菜单 项 时 ,实际 上 是 
从 启动 界面 跳 转 到 添加 联系 人 的 页 面 , 只 不 过 在 全 局 配置 文件 中 将 该 页 面 设置 成 对 话 框 模 
式 , 故 面向 用 户 则 为 一 个 对 话 框 。 该 对 话 框 页 面 的 布局 文件 代码 如 下 : 


« LinearLayout xmlns:android = "http://schemas.android. con/apk/res/android" 
android:id= "@ + id/layout dialog" 
android:layout width- "fill parent" 
android:layout height - "fill parent" 
android:orientation = "vertical" 
android: padding = "10dp" > 


< LinearLayout 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "姓名 : " /> 


< EditText 

android:id= "@ + id/edit name" 
android: layout_width = "200dp" 
android:layout height = "wrap content" 
android:background = "(Qdrawable/contact edit edittext normal" 
android:cursorVisible - "false" 
android:paddingLeft = "2.5dp" /> 

«/LinearLayout > 


< LinearLayout 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:orientation = "horizontal" 
android:paddingTop = "10dp" > 


« TextView 
android:layout width = "wrap content" 
android:layout height - "wrap content" 
android:text = "电话 : " /> 


«EditText 
android:id- "(à + id/edit phone" 
android:layout width = "200dp" 
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android:layout height = "wrap content" 
android:background = "(2drawable/contact edit edittext normal" 
android:cursorVisible - "false" 
android:paddingLeft = "2. 5dp" 
android:phoneNumber = "true" /> 
«/LinearLayout > 


< LinearLayout 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:orientation = "horizontal" 
android:paddingTop = "10dp" > 


< TextView 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:text = "邮件 : " /> 


« EditText 

android:id- "(à + id/edit email" 
android:layout width = "200dp" 
android:layout height = "wrap content" 
android:background = "(Qdrawable/contact edit edittext normal" 
android:cursorVisible = "false" 
android:paddingLeft = "2.5dp" /> 

«/LinearLayout > 


< Button 
android: id= "(2 + id/button" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center horizontal" 
android:layout marginTop - "6dp" 
android:background = "(Zdrawable/style button" 
android:paddingBottom = "3dp" 
android:paddingLeft = "50dp" 
android:paddingRight = "50dp" 
android:paddingTop - "3dp" 
android:text = "添加 ”/> 


</LinearLayout > 
代码 文件 : codes\09\9.3\ContactResolverDemo\res\layout\dialog_add_contact. xml 


上 面 的 布局 从 上 而 下 放置 了 三 个 文本 输入 框 ,供用 户 输入 姓名 、 手 机 号 码 、 邮 箱 地 址 三 
个 手机 联系 人 属性 ; 一 个 Button 按钮 供用 户 单 击 完成 手机 联系 人 的 添加 。 该 联系 人 添加 
页 面 对 应 的 核心 代码 如 下 : 


package cn. edu. hstc. contactresolverdemo. activity; 
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import android. app. Activity; 

import android. content. ContentUris; 

import android. content. ContentValues; 

import android. net. Uri; 

import android. os. Bundle; 

import android. provider. ContactsContract. CommonDataKinds. Email; 
import android. provider. ContactsContract. CommonDataKinds. Phone; 
import android. provider. ContactsContract. CommonDataKinds. StructuredName; 
import android. provider. ContactsContract. RawContacts; 

import android. provider. ContactsContract. RawContacts. Data; 
import android. view. View; 

import android. view. Window; 

import android. view. WindowManager; 

import android. widget. Button; 

import android. widget. EditText; 

import android. widget. Toast; 


public class AddContactActivity extends Activity ( 
private EditText nameEdit, phoneEdit, emailEdit; 
private Button addBtn; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
this.getWindow(). setFlags(WindowManager.LayoutParams. FLAG FULLSCREEN, 
WindowManager.LayoutParams.FLAG FULLSCREEN); 
this.requestWindowFeature(Window.FEATURE NO TITLE); 
setContentView(R. layout.dialog add contact); 
initView(); 


private void initView() { 
nameEdit - (EditText) findViewById(R. id. edit name); 
phoneEdit (EditText) findViewById(R. id. edit phone); 
emailEdit - (EditText) findViewById(R. id.edit email); 
addBtn = (Button) findViewById(R. id. button); 
addBtn. setOnClickListener(new View.OnClickListener() ( 
@Override 
public void onClick(View v) { 
// 获 取 程 序 界面 中 的 三 个 文本 框 
String nameStr = nameEdit.getText().toString(); 
String phoneStr = phoneEdit.getText().toString(); 
String emailStr = emailEdit.getText().toString(); 





if (nameStr.equals("") || phoneStr. equals("") || emailStr.equals("")) ( 
Toast.makeText (AddContactActivity.this, "请 填写 完整 信息 !"，3000). show() ; 


} else { 
// 创 建 一 个 空 的 ContentValues 
ContentValues values = new ContentValues(); 


273 


(ne Android 应 用 开发 从 入 门 到 精通 


// 向 RawContacts. CONTENT URI 执行 一 个 空 值 插入 ， 

// 目 的 是 获取 系统 返回 的 rawContactId 

Uri rawContactUri = getContentResolver(). insert(RawContacts.CONTENT_ 
URI, values); 

long rawContactId = ContentUris.parseId(rawContactUri); 


values.clear(); 

values.put(Data.RAW CONTACT ID, rawContactId); 

// 设 置 内 容 类 型 

values.put(Data.MIMETYPE, StructuredName. CONTENT ITEM TYPE); 

// 设 置 联系 人 名 字 

values. put (StructuredName. GIVEN_NAME, nameStr); 

// 向 联系 人 URI 添加 联系 人 名 字 

getContentResolver( ). insert (android. provider. ContactsContract. Data. 

CONTENT URI, values); 


values.clear(); 

values.put(Data.RAW CONTACT ID, rawContactId); 

values.put(Data.MIMETYPE, Phone.CONTENT ITEM TYPE); 

// 设 置 联系 人 的 电话 号 码 

values. put (Phone. NUMBER, phoneStr); 

// 设 置 电 话 类 型 

values. put (Phone. TYPE, Phone. TYPE MOBILE); 

// 向 联系 人 电话 号 码 URI 添加 电话 号 码 

getContentResolver( ) . insert (android. provider. ContactsContract. Data. 

CONTENT URI, values); 


values.clear(); 

values.put(Data.RAW CONTACT ID, rawContactld); 

values. put(Data. MIMETYPE, Email. CONTENT ITEM TYPE); 

// 设 置 联系 人 的 E-mail 地 址 

values.put(Email.DATA, emailStr); 

// 设 置 该 电子 邮件 的 类 型 

values. put (Email. TYPE, Email. TYPE WORK); 

// 向 联系 人 Email URI 添加 Email 数据 

getContentResolver( ). insert (android. provider. ContactsContract. Data. 

CONTENT URI, values); 


Toast. makeText (AddContactActivity. this, "联系 人 数据 添加 成 功 "，3000). 
show(); 
AddContactActivity. this. finish(); 


代码 文件 : codes V 09 V 9. 3 \ ContactResolverDemo V cn V edu V hste V activity V 
AddContactActivity. java 
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上 面 的 程序 实现 向 手机 联系 人 应 用 中 插入 一 行 空 值 ,然后 根据 返回 的 ID, 分 三 步 通过 
ContentResolver 插入 联系 人 的 姓名 、 手 机 号 码 .邮箱 地 址 三 个 联系 人 属性 。 

接 下 来 ,实现 查询 联系 人 并 显示 在 ExpandableListView 组 件 上 ,查询 操作 的 核心 代码 
如 下 : 


private void initSearch() { 
// 定 义 两 个 List 来 封装 系统 的 联系 人 信息 、 指 定 联系 人 的 电话 号 码 .E- mail 等 详情 
final ArrayList < String» names = new ArrayList < String>(); 
final ArrayList < ArrayList < String>> details = new ArrayList < ArrayList < String>>(); 
// 使 用 ContentResolver 查找 联系 人 数据 
Cursor cursor = getContentResolver ( ). query (ContactsContract. Contacts. CONTENT _ URI, 
null, null, null, null); 
// 人 遍历 查询 结果 ,获取 系统 中 所 有 联系 人 
while (cursor.moveToNext()) { 
// 获 取 联系 人 ID 
String contactId = cursor. getString (cursor. getColumnIndex ( ContactsContract. 
Contacts. ID)); 
// 获 取 联系 人 的 名 字 
String name = cursor. getString (cursor. getColumnIndex (ContactsContract. Contacts. 
DISPLAY NAME)); 
names. add(name) ; 
// 使 用 ContentResolver 查找 联系 人 的 电话 号 码 
Cursor phones = getContentResolver().query(ContactsContract. CommonDataKinds. Phone. 
CONTENT URI, null, 
ContactsContract. CommonDataKinds. Phone. CONTACT ID + ”= " + contactld, 
null, null); 
ArrayList < String» detail = new ArrayList «String»(); 
// 遍 历 查询 结果 ,获取 该 联系 人 的 多 个 电话 号 码 
while (phones. moveToNext()) ( 
// 获 取 查询 结果 中 电话 号 码 列 中 数据 
String phoneNumber = phones. getString(phones. getColumnIndex(ContactsContract. 
CommonDataKinds. Phone. NUMBER) ) ; 
detail.add(" iif 83: " + phoneNumber); 
) 
phones. close(); 
// 使 用 ContentResolver 查找 联系 人 的 E-mail 地 址 
Cursor emails = getContentResolver().query(ContactsContract. CommonDataKinds. Email. 
CONTENT URI, null, 
ContactsContract. CommonDataKinds. Email. CONTACT ID + " = " + contactld, 
null, null); 
// 遍 历 查询 结果 ,获取 该 联系 人 的 多 个 了 E- mail 地 址 
while (emails.moveToNext()) { 
// 获 取 查询 结果 中 了 ~- mail 地 址 列 中 数据 
String emailAddress = emails.getString(emails.getColumnIndex(ContactsContract. 
CommonDataKinds. Email.DATA)); 
detail.add(" 邮 件 地 址 : ”+ enailAddress); 
emails.close(); 
details.add(detail); 
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cursor.close(); 
// 加 载 result. xml 界面 布局 代表 的 视图 
View resultDialog = getLayoutInflater(). inflate(R.layout.listview result, null); 
// 获 取 xesultDialog 中 ID 为 list 的 ExpandableListView 
ExpandableListView list = (ExpandableListView) resultDialog. findViewById(R. id. list); 
// 创 建 一 个 ExpandableListAdapter Xj $& 
ExpandableListAdapter adapter = new BaseExpandableListAdapter() { 

// 获 取 指 定 组 位 置 .指定 子 列表 项 处 的 子 列表 项 数据 

@Override 

public Object getChild(int groupPosition, int childPosition) ( 

return details.get(groupPosition).get(childPosition); 


(QOverride 
public long getChildId(int groupPosition, int childPosition) ( 
return childPosition; 


(QOverride 
public int getChildrenCount(int groupPosition) ( 
return details.get(groupPosition).size(); 


private TextView getTextView() ( 
AbsListView.LayoutParams lp = new AbsListView. LayoutParams(ViewGroup. 
LayoutParams.FILL PARENT, 64); 
TextView textView = new TextView(MainActivity. this); 
textView. setLayoutParams(lp); 
textView.setGravity(Gravity. CENTER VERTICAL | Gravity.LEFT); 
textView. setPadding(56, 0, 0, 0); 
textView. setHeight(LinearLayout.LayoutParams.WRAP CONTENT); 
textView. setTextSize(16); 
return textView; 


// 该 方法 决定 每 个 子 选项 的 外 观 
(QOverride 
public View getChildView(int groupPosition, int childPosition, boolean isLastChild, 
View convertView, ViewGroup parent) ( 
TextView textView = getTextView(); 
textView.setText(getChild(groupPosition, childPosition).toString()); 
return textView; 


// 获 取 指 定 组 位 置 处 的 组 数据 

@Override 

public Object getGroup( int groupPosition) { 
return names. get (groupPosition); 
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public int getGroupCount() ( 
return names. size(); 


) 


(QOverride 
public long getGroupId(int groupPosition) ( 
return groupPosition; 


) 


// 该 方法 决定 每 个 组 选项 的 外 观 
@Override 
public View getGroupView(int groupPosition, boolean isExpanded, View convertView, 
ViewGroup parent) { 
TextView textView 7 getTextView(); 
textView. setText(getGroup(groupPosition).toString()); 
return textView; 


) 


(QOverride 
public boolean isChildSelectable(int groupPosition, int childPosition) ( 
return true; 


) 


(QOverride 
public boolean hasStableIds() { 
return true; 
) 
H 
// 为 ExpandableListView 设置 Adapter 对 象 
list. setAdapter(adapter); 
// 使 用 对 话 框 来 显示 查询 结果 。 
new AlertDialog.Builder(MainActivity. this). setView(resultDialog). setPositiveButton(" 确 
$E", null).show(); 
) 


上 面 的 程序 使 用 ContentResolver 匹配 ContactsContract. Contacts. CONTENT. URI 
将 系统 中 所 有 的 联系 人 信息 查询 出 来 ,接着 使 用 ContentResolver 匹配 ContactsContract. 
CommonDataKinds. Phone. CONTENT_URI 查询 出 指定 联系 人 的 电话 信息 ,接着 使 用 
ContentResolver 匹配 ContactsContract. CommonDataKinds. Email. CONTENT_URI 查询 
出 指定 联系 人 的 E-mail 信息 。 最 后 ,程序 通过 一 个 ExpandableListView 显示 了 所 有 的 联 
系 人 信息 。 

需要 指出 的 是 ,本 应 用 涉及 读 取 、 添 加 联系 人 的 操作 ,因此 需要 在 AndroidManifest. 
xml 配置 文件 中 为 该 应 用 程序 授权 ,授权 代码 片段 如 下 : 


<! -- 授予 读 联系 人 ContentProvider 的 权限 --> 

« uses - permission android:name = "android. permission. READ CONTACTS" /> 
<! -- 授予 写 联系 人 ContentProvider 的 权限 --> 

<uses - permission android:name = "android. permission. WRITE CONTACTS" /> 
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本 应 用 中 涉及 的 创建 Menu 菜单 项 ,为 菜单 项 添加 选中 事件 以 及 使 用 ExpandableList View 














9 知识 点 并 不 是 本 章 要 介绍 的 内 容 , 因 此 此 处 不 再 列 出 这 部 分 的 代码 ,读者 可 以 通过 阅读 本 
书 所 附带 的 源码 进行 学 习 。 


为 了 演示 本 应 用 ,将 程序 部 署 于 Android 模拟 器 上 ,部 署 成 功 后 , 先 打开 Android 系统 
自 带 的 联系 人 应 用 Contacts ,可 以 看 到 如 图 9. 4 所 示 的 效果 。 
接着 ,启动 上 面 所 编写 的 应 用 ,根据 界面 中 的 提示 按 下 手机 硬 键盘 上 的 Menu 键 , 可 以 


看 到 如 图 9 





.5 所 示 的 效果 。 
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添加 查询 


未 添加 任何 联系 人 的 Contacts 图 9.5 Menu 键 功能 


单 击 底 部 菜单 中 的 “添加 ”按钮 ,将 会 弹出 一 个 新 增 联系 人 信息 对 话 框 ,在 该 对 话 框 中 的 
:个 文本 输入 框 中 分 别 填 入 姓名 、 电 话 、 邮 件 地 址 信息 ,如 图 9.6 所 示 。 
单 击 图 9.6 中 的 “添加 ”按钮 ,成功 将 该 联系 人 信息 插入 系统 联系 人 应 用 中 ,此 时 ,再 次 
打开 系统 自 带 的 联系 人 应 用 Contacts, 可 以 看 到 如 图 9.7 所 示 的 效果 。 
单 击 图 9.7 中 的 列表 项 Tom ,可 以 看 到 联系 人 的 详细 信息 , 正 是 图 9. 6 中 所 输入 的 对 


应 信息 ,说 


明 刚 才 通 过 应 用 成 功 将 联系 人 信息 插入 ,其 效果 如 图 9. 8 所 示 。 


继续 通过 应 用 插入 两 个 联系 人 信息 ,然后 单 击 图 9. 5 中 的 第 二 个 菜单 项 触发 查询 按钮 


功能 ,并 展 


开 ExpandableListView 中 的 联系 人 信息 ,可 以 看 到 如 图 9.9 所 示 的 效果 。 


以 上 通过 ContentResolver 对 系统 自 带 的 联系 人 应 用 所 暴露 的 ContentProvider 数据 


进行 增 、 查 


两 个 操作 。 实 际 上 ,Android 系统 还 提供 了 大 量 的 其 他 应 用 的 ContentProvider， 


例如 为 音频 、 视 频 、 图 片 等 多 媒体 提供 的 内 容 提 供 者 ContentProvider。 通 过 以 上 介绍 的 对 
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HI BE ,读者 应 能 够 通过 查阅 Android 官方 文档 获得 该 ContentProvider 所 提供 


的 Uri, 然 后 进行 对 应 数据 管理 操作 。 
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图 9.7 添加 了 联系 人 信息 的 Contacts 
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图 9.9 查询 联系 人 信息 
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6.4 监听 ContentProvider 的 数据 改变 


通过 上 面 的 介绍 ,已 经 知道 Android 提供 了 ContentResolver 供用 户 操作 应 用 
ContentProvider 所 暴露 的 数据 ,但 这 属于 用 户主 动 操作 ContentProvider 中 的 数据 ,试想 : 
如 果 应 用 中 的 数据 变化 了 ,如 果 此 前 ContentResolver 已 经 查询 过 ContentProvider 中 的 数 
据 了 ,那么 该 如 何 通 知 ContentResolver. ContentProvider 中 数据 的 已 变化 呢 ? 

细心 的 读者 或 许 已 经 发 现 ,在 实现 9. 1 节 中 的 应 用 ContentProviderDemo 中 的 
BookProvider 时 ,在 实现 insert, delete, update. 三 个 方法 中 ,都 有 如 下 的 一 句 代 码 行 : 
getContext(). getContentResolver(). notifyChange(uri, null) ,这 行 代码 的 作用 正 是 用 来 通 
知 注册 在 该 Uri 上 的 监听 者 一 一 该 ContentProvider 所 共享 的 数据 发 生 了 改变 。 只 要 是 
ContentProvider 中 的 数据 发 生 改变 ,程序 便 可 以 调用 该 行 代码 。 

为 了 在 应 用 程序 中 监听 ContentProvider 中 数据 的 改变 ,需要 利用 Android 提供 的 
ContentObserver 基 类 。 接 下 来 ,将 通过 一 个 小 程序 来 介绍 如 何 使 用 ContentObserver 来 监 
Wr ContentProvider 中 数据 的 变化 。 

要 实现 的 应 用 的 需求 为 : 通过 实现 一 个 BoradcastReceiver 来 拦截 Android 模拟 器 接收 
到 的 短信 ,并 将 短信 内 容 显 示 在 页 面 的 TextView 组 件 上 。 由 于 该 应 用 界面 非常 简单 ,只 居 
中 放置 了 一 个 TextView 控件 , 故 不 在 此 处 给 出 布局 文件 源 代码 。 

实现 该 应 用 核心 功能 的 思路 为 自 定 义 一 个 ContentObserver 类 来 监听 系统 短信 应 用 的 
ContentProvider 数据 , 当 监 听 到 ContentProvider 中 有 数据 变化 时 ,通过 ContentResolver 
查询 收 件 箱 中 数据 ,如 果 有 未 读 消息 , 则 将 数据 以 消息 形式 发 送 给 一 个 Handler 类 ,在 该 
Handle 类 中 操作 界面 组 件 , 显 示 该 条 消息 。 在 本 应 用 中 ,考虑 将 自 定义 的 ContentObserver 
类 作为 应 用 中 唯一 的 Activity 中 的 内 部 类 ,该 应 用 的 Activity 类 实现 源码 如 下 : 


package cn. edu. hstc. contentobserverdemo. activity; 


import android. app. Activity; 

import android. database. ContentObserver; 

import android. database. Cursor; 

import android. net. Uri; 

import android. os. Bundle; 

import android. os. Handler; 

import android. widget. TextView; 

import cn. edu. hstc. contentobserverdemo. service. R; 


public class MonitorSmsActivity extends Activity ( 
(QOverride 
protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate( savedInstanceState); 
setContentView(R. layout.activity monitorsms); 


// 为 content://sms 的 数据 变化 注册 监听 器 
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getContentResolver().registerContentObserver(Uri.parse("content://sms"), true, new 
SmsObserver(MyHandler)); 
) 


private Handler MyHandler - new Handler() ( 
public void handleMessage(android. os. Message msg) ( 

Switch (msg. what) ( 

case 100: 
String body = (String) msg. obj; 
TextView tv = (TextView) findViewById(R. id.txt show sms); 
tv. setText(body) ; // 将 短信 信息 显示 在 界面 上 的 TextView 组 件 
break; 


}; 


// 自 定义 ContentObserver 监听 器 类 
private final class SmsObserver extends ContentObserver { 
private Handler handler; 


public SmsObserver(Handler handler) { 
super(handler); 
this.handler = handler; 


@Override 
public void onChange(boolean selfChange) { 

// 查 询 收 件 箱 中 的 短信 

Cursor cursor = getContentResolver(). query(Uri. parse("content://sms/inbox"), 
null, null, null, "date asc"); 

// 获 取 用 户 最 新 收 到 的 短信 

cursor.moveToLast() ; 

StringBuilder sb = new StringBuilder(); 

// 获 取 短 信 的 发 送 地 址 

sb. append(" 短 信 来 自 : ") .append(cursor. getString(cursor.getColumnIndex 

("address"))); 

// 获 取 短 信 的 内 容 

sb. append("\r\n 短 信 内 容 : "). append(cursor. getString (cursor. getColumnIndex 
("body"))); 

//readType 表示 是 否 已 经 读 

int hasRead = cursor.getInt(cursor. getColumnIndex("read")); 

if (hasRead == O)( // 表 示 短 信 未 读 

System. out. println(" 短 信 未 读 : " + cursor.getString(cursor. getColumnIndex 
("address"))); 
handler. obtainMessage(100, sb. toString()). sendToTarget() ; 
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) 


代码 文件 : codes\09\9. 4\ContentObserverDemo\cn\edu\hstc\activity\MonitorSmsActivity. java 


从 上 面 的 程序 可 以 看 出 ,实现 监听 ContentProvider 数据 的 改变 其 实 非 常 简单 ,只 需要 
按照 如 下 步骤 即 可 。 

(D 自 定义 一 个 监听 器 类 继承 自 ContentObserver W% 。 

© 3&3 ContentObserver 基 类 所 定义 的 onChange(booleanselfChange) 方 法 , 当 所 监听 
的 ContentProvider 的 数据 发 生 改变 时 ,将 会 触发 该 方法 。 

© 向 指定 Uri 注册 ContentObserver 监听 器 ,如 下 面 代码 所 示 : 

// 为 content://sms 的 数据 变化 注册 监听 器 


getContentResolver(). registerContentObserver (Uri. parse( " content://sms"), true, new SmsObserver 
(MyHandler) ) ; 


从 以 上 代码 行 可 以 看 出 ,注册 ContentObserver 监听 器 的 方法 由 ContentResolver 提 
供 , 实 际 上 ,该 方法 的 模型 如 下 : 
registerContentObserver ( Uri uri. boolean notifyForDescendents, ContentObserver 


observer) ,该 方法 中 的 三 个 参数 的 说 明 如 表 9. 3 所 示 。 
表 9.3 注册 ContentObserver 监听 器 的 方法 的 参数 说 明 


参 数 名 EJ 述 
uri 该 监听 器 所 监听 的 ContentProvider 的 Uri 
如 果 该 参数 为 true, 假 如 注册 监听 的 Uri 为 content://abc, 那 么 Uri 为 content:// 
abc/xyz、content://abc/xyz/foo 的 数据 改变 时 也 会 触发 该 监听 器 ; 如 果 该 参数 为 
false, 假 如 注册 监听 的 Uri 为 content://abc, 那 么 只 有 content://abc 的 数据 发 生 
改变 时 会 触发 该 监听 器 
observer 监听 器 实例 








notifyForDescendents 








在 上 面 的 程序 中 , 当 所 监听 的 ContentProvider 的 数据 发 生 改 变 时 ,也 就 是 当 系统 短信 
应 用 的 ContentProvider 中 的 数据 发 生 改 变 时 ,将 会 触发 上 面 程序 中 所 实现 的 
ContentObserver 基 类 的 onChange(boolean selfChange) 方 法 ,因此 所 实现 的 逻辑 业务 代码 
也 将 放 在 该 方法 中 。 

将 上 面 所 实现 的 应 用 部 署 在 Android 模拟 器 5554 中 ,运行 效果 如 图 9. 10 所 示 。 

从 图 9. 10 中 可 以 看 出 ,此 时 的 应 用 界面 没有 显示 任何 数据 ,打开 另 一 个 Android 模拟 
器 5556 并 启动 其 自 带 的 短信 应 用 Messaging. 再 向 模拟 器 5554 中 发 送 一 条 短信 消息 
"test" ,发 送 成 功 后 ,返回 模拟 器 5554, 将 可 以 看 到 如 图 9. 11 所 示 界 面 。 

从 图 9. 11 的 显示 界面 可 以 看 出 ,应 用 已 成 功 监 听 到 短信 应 用 的 ContentProvider 中 的 
数据 的 改变 ,并 将 收 件 箱 的 Uri 中 的 数据 查询 出 来 ,如 果 是 未 读 消息 , 则 显示 在 界面 中 。 

通过 以 上 应 用 的 实现 以 及 演示 ,监听 ContentProvider 中 的 数据 改变 的 实现 流程 已 全 部 
介绍 完毕 。 
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短信 来 自 : 15555215556 
短信 内 容 : test 


9.10 应 用 启动 效果 图 9.11 成 功 监听 短信 应 用 的 ContentProvider 


9.5 本 章 小 结 
— 


本 章 主 要 介绍 了 Android 四 大 组 件 之 一 的 ContentProvider 的 用 法 和 功能 。 应 用 程序 
可 以 通过 ContentProvider 暴露 自身 数据 ,其 他 应 用 通过 ContentResolver 来 操作 
ContentProvider 所 暴露 的 数据 。 读 者 需要 掌握 的 是 实现 自己 的 ContentProvider 以 及 使 用 
ContentResolver 操作 Android 系统 所 提供 的 大 量 现 有 的 ContentProvider 或 自 定义 的 
ContentProvider。 除 此 之 外 ,还 需要 掌握 使 用 另 一 个 工具 基 类 ContentObserver ,实现 自 定 
义 的 ContentObserver 来 监听 ContentProvider 中 的 数据 改变 。 





. Android 的 网 络 编程 


手机 的 确 给 人 们 的 工作 和 生活 带 来 不 少 方便 ,1995 年 问世 的 第 一 代 (1G) 模 拟 制式 手机 
还 只 能 进行 语音 通话 ; 1996 一 1997 年 出 现 的 第 二 代 (2G)GSM、CDMA 等 数字 制式 手机 增 
加 了 接收 数据 (如 电子 邮件 或 网 页 ) 等 功能 ; 而 2009 年 诞生 的 3G ,其 功能 更 是 让 人 眼花 练 
乱 , 比 如 高 速 的 无 线 宽带 上 网 视频 通话 、 无 线 搜索 、 手 机 音乐 .手机 网 游 等。 无 线 网 络 发 展 
的 速度 也 非常 迅 邦 。 有 了 无 线 网 络 的 支持 ,人 们 就 不 必 受 时 间 和 空间 的 限制 ,可 随时 随地 进 
行 数据 交换 ,浏览 Internet ,第 一 时 间 获 得 新 闻 资讯。 随 着 人 们 知识 水 平 的 提高 ,生活 圈 的 
扩大 ,人 们 更 需要 网 络 的 帮助 来 处 理 一 些 事务 ,比如 手机 炒股 .手机 证 券 . 手 机 银行 .手机 地 
图 等 。 在 Android 中 ,掌握 了 网 络 通信 便 可 以 开发 出 这 些 优 秀 的 网 络 应 用 。 

Android 完全 支持 JDK 本 身 的 TCP,UDP 网 络 通信 协议 ; 也 可 以 使 用 ServerSocket、 
Socket 来 建立 基于 TCP/IP 的 网 络 通信 ; 还 可 以 使 用 DatagramSocket, Datagrampacket , 
MulticastSocket 来 建立 基于 UDP 的 网 络 通信 。 同 时 ,Android 也 支持 JDK 提供 的 URL, 
URLConnection 等 网 络 通 信 API。 

更 重要 的 是 ,Android 内 置 的 HttpClient 更 是 可 以 非常 方便 地 发 送 HTTP 请 求 ,并 获 
Ik HTTP 响应 ,通过 HttpClient, Android 简化 了 与 网 站 之 间 的 数据 交互 。 接 下 来 将 会 重点 
介绍 以 上 提 到 的 Android 网 络 编程 技术 。 


(0.1 使 用 Socket 通信 搭建 简易 聊天 室 


本 节 将 通过 实现 一 个 使 用 ServerSocket 搭建 的 服务 端 以 及 一 个 使 用 Socket 进行 通信 
的 客户 端 ,形成 一 个 简易 的 聊天 室 , 向 读者 介绍 基于 TCP 的 网 络 通 信 的 搭建 。 

需求 很 简单 ,服务 端 不 断 监听 来 自 客户 端的 连接 , 当 有 一 个 客户 端 与 其 连接 成 功 后 ,将 
会 启动 一 个 线程 为 该 客户 端 服务 。 而 客户 端 只 有 一 个 与 用 户 交互 的 Activity, 在 该 页 面 中 ， 
放置 一 个 文本 输入 框 供用 户 输入 文本 ,一 个 发 送 按钮 供用 户 单 击 后 将 输入 文本 上 传 网 络 中 ， 
服务 端 则 循环 不 断 地 从 客户 端 中 读 取 发 送 过 来 的 数据 ,然后 将 数据 发 送 到 每 个 已 经 与 服务 
端 形成 连接 的 客户 端 中 ,客户 端 将 接收 到 的 数据 显示 在 Activity 中 的 聊天 记录 显示 框 中 。 

从 以 上 需求 可 以 得 出 ,至 少 需要 实现 一 个 服务 端 程序 并 正常 运行 。 该 服务 端 程序 作为 
普通 的 Java Application 存在 。 新 建 一 个 普通 的 Java 项 目 命名 为 ServerSocketDemo ,新 建 
包 , 在 包 下 新 建 一 个 Java 类 ,命名 为 TestServerSocket。 实 现 TestServerSocket 中 的 程序 代 
码 ,如 下 : 
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package cn. edu. hstc. serversocketdemo. util; 


import java. io. IOException; 
import java. net. ServerSocket; 
import java. net. Socket; 
import java. util. ArrayList; 


public class TestServerSocket { 
// 定 义 保 存 所 有 Socket 的 ArrayList 
public static ArrayList < Socket» socketList = new ArrayList < Socket >(); 


public static void main(String[ ] args) throws IOException { 
ServerSocket serverSocket = new ServerSocket(30000); 
while (true) ( 


// 此 行 代码 会 阻塞 , 将 一 直 等 待 别人 的 连接 
Socket socket = serverSocket. accept(); 
SocketList. add( socket) ; 


// 每 当 客户 端 连接 后 启动 一 条 ServerThread 线程 为 该 客户 端 服务 
new Thread(new ServerThread(socket)).start(); 


) 


代码 文件 : codes\10\10. INServerSocketDemoVcnVeduMhstcVutilVTestServerSocket. java 


上 面 的 程序 实现 不 断 监听 来 自 客户 端的 Socket 连接 ,考虑 到 服务 端 使 用 传统 的 
BufferedReader 的 readLine 方法 读 取 数据 时 , 当 该 方法 成 功 返回 之 前 ,线程 被 阻塞 ,程序 无 
法 继续 执行 ,一 旦 连接 成 功 ,服务 端 将 会 启动 一 个 线程 为 其 服务 。 程 序 中 代码 行 new 
Thread(new ServerThread(socket)). start 方法 就 实现 了 该 需求 。 因 此 ,还 需要 实现 一 个 线 
FEZ ,来 处 理 连 接 后 的 逻辑 业务 。 该 线程 为 ServerThread 类 所 代表 ,该 类 源码 如 下 : 


package cn. edu. hstc. serversocketdemo. util; 


import java. io. BufferedReader; 
import java. io. IOException; 

import java. io. InputStreamReader; 
import java. io. OutputStream; 
import java. net. Socket; 

import java. text. SimpleDateFormat; 
import java. util. Date; 


public class ServerThread implements Runnable ( 
// 定 义 当 前 线程 所 处 理 的 Socket 
Socket socket = null; 
// 该 线程 所 处 理 的 Socket 所 对 应 的 输入 流 
BufferedReader br = null; 


public ServerThread( Socket socket) throws IOException { 
this. socket = socket; 
// 初 始 化 该 Socket 对 应 的 输入 流 
br = new BufferedReader(new InputStreamReader(socket.getInputStream(), "utf -8")); 
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} 


public void run() { 
tryí 
String content - null; 
// 采 用 循环 不 断 从 Socket 中 读 取 客 户 端 发 送 过 来 的 数据 
while ( (content = readFromClient()) != null) ( 
/ il Bj socketList 中 的 每 个 Socket, 
// 将 读 到 的 内 容 向 每 个 Socket 发 送 一 次 
for (Socket socket : TestServerSocket. socketList) { 
OutputStream os = socket.getOutputStream(); 
os.write((packMessage(content) + "Wn").getBytes("utf - 8")); 
) 
) 
) catch (IOException e) { 
e. printStackTrace(); 
) 
) 


// 定 义 读 取 客 户 端 数据 的 方法 
private String readFromClient() ( 
try { 
return br. readLine(); 


) 
/ An fil d 59] 5j , RIIA Socket 对 应 的 客户 端 已 经 关闭 
catch (IOException e) ( 
// 删 除 该 Socket, 
TestServerSocket. socketList. remove( socket); 
} 
return null; 


} 


private String packMessage(String content) { 
String result = null; 
SimpleDateFormat df = new SimpleDateFormat("HH:mm:ss"); // 设 置 日 期 格式 
String message = content. substring(content. indexOf(": ") + 1); 
// 获 取 用 户 发 送 的 真实 的 信息 

if (content. startsWith("5554")) ( 

// 获 取 用 户 发 送 的 真实 的 信息 

result = "Vn" + "5554 " + df.format(new Date()) + "Wn" + message; 
) 
if (content. startsWith("5556")) ( 

result = "Vn" + "5556 " + df.format(new Date()) + "Wn" + message; 
) 


return result; 


代码 文件 : codes\10\10.1\ServerSocketDemo\cn\edu\hstc\util\ServerThread. java 


上 面 的 程序 实现 不 断 从 Socket 中 读 取 来 自 客 户 端的 数据 , 当 有 数据 时 , 则 循环 将 数据 
写 入 服务 端 与 各 个 客户 端的 Socket 连接 中 ,并 且 对 数据 进行 了 重新 封装 ,为 数据 添加 了 发 
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送 者 以 及 发 送 时 间 。 

至 此 ,服务 端 程序 的 全 部 代码 已 全 部 实现 。 

服务 端 程序 中 的 TestServerSocket 类 中 有 代码 行 ServerSocket serverSocket — new 
ServerSocket(30000) ,这 里 实例 化 了 一 个 ServerSocket 类 。 那 么 该 类 的 作用 是 什么 ”又 为 
何在 构造 器 中 传人 数字 30000 呢 ? 

ServerSocket 类 作为 Java 中 能 够 接收 其 他 通信 实体 连接 请 求 的 类 存在 ,ServerSocket 
对 象 用 于 监听 来 自 客户 端的 Socket 连接 ,如 果 没 有 连接 , 它 将 一 直 处 于 等 待 状态 。 表 10.1 
简单 描述 了 ServerSocket 中 的 监听 方法 以 及 各 个 构造 器 方法 。 


表 10.1 ServerSocket 中 的 监听 连接 请 求 的 方法 以 及 各 个 构造 器 方法 








方 法 名 描 述 
如 果 接 收 到 一 个 客户 端的 Socket 连接 请 求 ,该 方法 将 返回 一 个 与 
Socket accept() 连接 客户 端 Socket 对 应 的 Socket, 否则 该 方法 一 直 处 于 等 待 状 
态 ,线程 也 被 阻塞 
创建 一 个 指定 的 端口 号 port 的 ServerSocket, 该 端口 号 port 的 有 


ServerSocket(int port) 
rverSocket(int por 效 取 值 范围 为 0 一 65 535 


ServerSocket(int port, int backlog) 增加 一 个 用 来 改变 连接 队列 长 度 的 参数 backlog 

ServerSocket (int port. int backlog, | 在 机 器 存在 多 个 IP 地 址 的 情况 下 ,允许 通过 参数 localAddress 来 
InteAddress localAddress) 指定 将 ServerSocket 绑 定 到 指定 的 IP 地 址 

close() 当 ServerSocket 使 用 完毕 后 ,使 用 该 方法 来 关闭 该 ServerSocket 














在 本 实例 中 的 服务 端 程序 TestServerSocket 类 中 ,利用 while(true){) 代 码 块 调用 
ServerSocket 的 accept 方法 实现 服务 端 不 断 循环 监听 来 自 客户 端的 连接 请 求 。 在 此 之 前 ， 
创建 了 一 个 端口 号 为 30000 的 ServerSocket, 由 于 没有 指定 IP. 地 址 , 则 该 ServerSocket 将 
会 绑 定 到 本 机 默认 的 TP 地 址 。 通 常 推荐 使 用 1024 以 上 的 端口 号 ,主要 是 为 了 避免 与 其 他 
应 用 程序 的 通用 端口 冲突 。 

简易 聊天 室 的 客户 端 为 常规 的 Android 应 用 。 应 用 涉及 聊天 ,必定 涉及 与 用 户 的 交互 ， 
因此 ,APP 需要 实现 自 定义 的 交互 界面 一 一 Activity。 该 界面 布局 相对 简单 ,界面 项 部 分 左 
右 两 边 分 别提 供 一 个 文本 输入 框 供用 户 编 辑 发 送 文本 以 及 一 个 Button 发 送 按钮 供用 户 单 
击 后 将 文本 输入 框 中 的 内 容 上 传 网 络 中 ,在 这 两 个 控件 的 下 方 是 一 个 被 设置 成 不 可 获得 焦 
点 以 及 不 可 编辑 的 文本 输入 框 ,该 输入 框 用 于 显示 各 个 客户 端 之 间 的 聊天 记录 。 布 局 代码 
如 下 : 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height - "match parent" 
android:orientation = "vertical" > 


< LinearLayout 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
android:orientation = "horizontal" > 


«EditText 
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android:id= "@ + id/input" 
android: layout width= "240px" 
android: layout_height = "wrap content" /> 


< Button 
android:id- "(9 + id/send" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:paddingLeft = "8px" 
android:text = "发 送 " /> 
</LinearLayout > 


« EditText 
android:id- "(à + id/show" 
android:layout width = "fill parent" 
android:layout height = "fill parent" 
android:cursorVisible = "false" 
android:editable = "false" 
android:gravity = "top" /> 





«/LinearLayout > 
代码 文件 : codes\10\10. 1NSocketDemoVresMayoutVactivity main. xml 


编辑 完 界面 布局 ,需要 自 定 义 一 个 Activity 类 来 加 载 该 布局 并 实现 界面 中 各 个 控件 的 
业务 代码 ,该 Activity 类 Java 程序 代码 如 下 : 


package cn. edu. hstc. socketdemo. activity; 


import java. io. OutputStream; 
import java. net. Socket; 


import android. app. Activity; 

import android. os. Bundle; 

import android. os. Handler; 

import android. os. Message; 

import android. view. View; 

import android. view. View. OnClickListener; 

import android. widget.Button; 

import android. widget. EditText; 

import cn. edu. hstc. socketdemo. util.ClientThread; 


public class MainActivity extends Activity ( 
// 定 义 界面 上 的 两 个 文本 框 
private EditText input, show; 
// 定 义 界面 上 的 一 个 按钮 
private Button send; 
private OutputStream os; 
private Handler handler; 
private Socket socket; 


(QOverride 
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protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
setContentView(R. layout.activity main); 
input = (EditText) findViewById(R. id. input); 
send = (Button) findViewById(R. id. send) ; 
show = (EditText) findViewById(R. id. show) ; 


handler = new Handler() { 
(QOverride 
public void handleMessage(Message msg) ( 
// 如 果 消 息 来 自 于 子 线程 
if (msg. what == 0x123) { 
// 将 读 取 的 内 容 追 加 显示 在 文本 框 中 
show. append(msg. obj. toString() + "\n"); 


) 
}; 
try ( 
Socket = new Socket("192.168.1.102", 30000); 
// 客 户 端 启动 CLientThread 线程 不 断 读 取 来 自 服务 器 的 数据 
new Thread(new ClientThread(socket, handler)).start(); 
OS 7 socket.getOutputStream(); 
) catch (Exception e) ( 
e. printStackTrace(); 
) 
send. setOnClickListener(new OnClickListener() { 
(2 Override 
public void onClick(View v) ( 
try f 
// 将 用 户 在 文本 框 内 输入 的 内 容 上 传 网 络 
os.write(("5556: " + input. getText(). toString() + "\r\n").getBytes 
("utf - 8")); 
// 清 空 input 文本 框 
input. setText(""); 
) catch (Exception e) ( 
e. printStackTrace(); 
) 


n; 


代码 文件 : codes\10\10. 1\SocketDemo\cn\edu\hstc\socketdemo\activity\MainActivity. java 


上 面 的 程序 为 界面 中 的 发 送 按钮 绑 定 了 事件 监听 器 ,实现 按钮 单 击 事件 ,在 单 击 事件 方 
法 onClick 方法 中 实现 将 用 户 在 界面 文本 编辑 框 中 输入 的 内 容 写 入 客户 端 与 服务 端 连接 成 
功 后 所 返回 的 Socket 输出 流 中 并 将 文本 输入 框 清空 。 由 于 该 应 用 并 未 实现 登录 操作 , 故 无 
法 确定 输出 流 中 的 数据 来 自 于 哪个 客户 端 ,为 了 在 消息 记录 显示 框 中 显示 发 送 者 ,这 里 在 写 
入 流 中 的 数据 前 面 加 了 对 应 发 送 者 的 标识 ,可 用 任何 字符 串 类 型 的 文本 作 区 分 。 比 如 ,将 程 
序 中 “5556” 换 成 “5554”, 则 代表 输出 流 中 的 数据 是 从 5554 这 个 模拟 器 中 发 送出 来 的 消息 。 
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服务 端 程序 会 根据 流 中 内 容 的 前 面部 分 判断 消息 发 送 端 ,这 部 分 逻辑 可 以 通过 阅读 源码 体 
会 理解 。 

客户 端 程序 使 用 了 Handler 消息 传递 机 制 ,以 方便 地 获取 来 自 于 子 线程 中 的 数据 并 将 
数据 追加 到 聊天 消息 记录 框 中 。 这 部 分 逻辑 可 通过 阅读 上 面 程序 中 实现 Handler 类 的 代码 
了 解 。 程 序 中 通过 代码 行 new Thread(new ClientThread(socket, handler)). start() 将 所 
自 定义 的 Handler 类 与 子 线程 关联 起 来 。 在 该 子 线程 实现 类 中 ,主要 工作 是 读 取 Socket 输 
入 流 中 的 内 容 并 通过 发 送 handler 消息 通知 主 界面 更 新 数据 。 该 线程 类 源码 如 下 : 


package cn. edu. hstc. socketdemo. util; 


import java. io. BufferedReader; 
import java. io. IOException; 
import java. io. InputStreamReader; 
import java. net. Socket; 


import android. os. Handler; 
import android. os. Message; 


public class ClientThread implements Runnable ( 
private Handler handler; 
// 该 线程 所 处 理 的 Socket: 所 对 应 的 输入 流 
BufferedReader br = null; 


public ClientThread(Socket socket, Handler handler) throws IOException { 
this.handler - handler; 
br = new BufferedReader(new InputStreamReader(socket.getInputStream())); 
) 


public void run() ( 


try { 
String content = null; 
// 不 断 读 取 Socket 输入 流 中 的 内 容 


while ((content = br.readLine()) != null) ( 
// 每 当 读 到 来 自 服务 器 的 数据 之 后 ,发送 消 息 通知 程序 界面 显示 该 数据 
Message msg = new Message(); 
msg.what - 0x123; 
msg.obj = content; 
handler. sendMessage(nmsg) ; 
) 
} catch (Exception e) ( 
e. printStackTrace(); 
} 


代码 文件 : codes\10\10.1\SocketDemo\cn\edu\hstc\socketdemo\util\ClientThread. java 
至 此 ,实现 了 客户 端 写 入 操作 以 及 读 取 操作 ,那么 ,客户 端 又 是 如 何 实现 自身 与 服务 端 
的 连接 的 呢 ? 写 入 操作 以 及 子 线 程 中 的 读 取 操作 所 对 应 的 该 客户 端 与 服务 端的 Socket 又 
是 从 何 而 来 的 呢 ? 实际 上 ,在 MainActivity 类 中 有 如 下 一 行 代码 : 
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Socket = new Socket("192.168.1.102", 30000); 


客户 端正 是 通过 Socket 的 构造 器 来 连接 指定 的 服务 端的 。Socket 有 两 个 构造 器 ,如 
表 10.2 所 示 。 
表 10.2 Socket 对 应 的 构造 器 方法 


构造 器 方法 名 LEE: 
: 创建 连接 到 远程 主机 、 远 程 端口 的 Socket, 该 构造 器 默认 
Se (InteAddress/String remoteAddress， 使 用 本 地 主机 的 默认 TP 地 址 以 及 默认 使 用 系统 动态 指定 
int port) 

的 端口 
Socket ( InteAddress/String remoteAddress, | 创建 连接 到 远程 主机 、 远 程 端口 的 Socket, 并 指定 本 地 IP. 
int port) 地 址 和 端口 号 ,适用 于 本 地 主机 中 有 多 个 IP 地 址 的 情况 











程序 通常 使 用 String 类 型 的 IP 地 址 来 指定 远程 服务 端 。 由 于 服务 端 程序 中 实现 
ServerSocket 时 并 没有 指定 IP 地 址 ,这 里 服务 端 绑 定 的 是 作者 PC 的 IP 地 址 ,服务 端 程序 
也 运行 在 作者 的 PC 中 , 故 Socket 构造 器 中 的 远程 IP 为 作者 的 PC 的 IP 地 址 ,端口 号 为 创 
建 服 务 端 Socket 时 所 开辟 的 端口 号 , 即 30000, 

当 程 序 执行 创建 Socket 实例 的 代码 行 时 ,客户 端 便 会 连接 到 指定 的 服务 器 ,让 服务 端 
程序 中 的 ServerSocket 的 accept 方法 向 下 执行 。 于 是 服务 端 与 客户 端 就 产生 了 一 对 互相 
连接 的 Socket。 之 所 以 说 是 一 对 ,是 因为 Socket 通信 和 是 基于 TCP 的 ,而 TCP 的 简单 通信 
示意 图 如 图 10. 1 所 示 。 
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图 10.1 TCP 的 通信 示意 图 


从 图 10. 1 可 以 看 出 ,TCP 通信 的 两 个 通信 和 实体 之 间 并 没有 服务 端 \ 客 户 端 之 分 ,为 什 
么 在 程序 中 还 需要 对 其 进行 区 分 呢 ? 那 是 因为 ,这 是 两 个 通信 实体 已 经 建立 虚拟 链 路 之 后 
的 示意 图 。 在 两 个 通信 实体 没有 建立 虚拟 链 路 之 前 ,必须 有 一 个 通信 实体 先 做 出 “主动 姿 
态 ”, 主 动 接收 来 自 其 他 通信 实体 的 连接 请 求 。 通 常 , 将 做 出 主动 姿态 的 一 方 成 为 服务 端 ,并 
将 服务 端 程序 运行 在 PC 主机 中 ,接收 等 于 或 大 于 1 的 数量 的 客户 端的 连接 请 求 。 

当 客 户 端 与 服务 端 之 间 产 生 了 对 应 的 Socket 之 后 ,两 者 之 间 的 关系 就 如 图 10. 1 所 示 。 
此 时 程序 不 再 区 分 服务 器 、 客 户 端 ,而 是 通过 各 自 的 Socket 进行 通信 。 

细心 的 读者 在 阅读 了 源码 后 会 发 现 ,不 管 是 服务 端 Socket 还 是 客户 端 Socket ,都 可 以 
通过 getInputStream 获得 各 自 Socket 对 象 所 对 应 的 输入 流 以 及 通过 getOutputStream 获 
得 其 Socket 对 象 所 对 应 的 输出 流 。 简 单 总 结 如 下 : 
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æ InputStream getInputStream 一 一 返回 Socket 对 象 对 应 的 输入 流 ,程序 通过 该 输入 流 
从 Socket 中 读 取 数据 ; 
t OutputStream getOutputStream 一 一 返回 Socket 对 象 对 应 的 输出 流 , 程 序 通过 该 输 
出 流向 Socket 中 写 入 数据 。 
运行 服务 端 , 即 运行 Java 应 用 ServerSocketDemo, 然 后 打开 两 个 模拟 器 ,将 客户 端 程序 
SocketDemo 部 署 在 两 个 模拟 器 5554 和 5556 中 ,然后 进行 聊天 对 话 ,可 以 看 到 如 图 10.2 和 
图 10. 3 所 示 效 果 。 
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5554 21:53:59 


5554 21:53:59 


WB, 明天 打球 ? Vg, BEXSIER? 
5556 21:55:09 5556 21:55:09 
好 啊 ! 明天 见 ! 好 啊 ! 明天 见 ! 
5554 21:55:31 5554 21:55:31 


图 10.2 5554 客户 端 Æ 10.3 5556 客户 端 


(10.2. 使 用 HTTP 访问 网 络 
A 

Android 对 HTTP( 超 文本 传输 协议 ) 也 提供 了 很 好 的 支持 ,在 Android 中 ,使 用 http 
访问 网 络 有 两 种 方式 : 一 种 是 使 用 HttpURLConnection; 另 一 种 是 使 用 HttpClient。 接 下 
来 , 先 介 绍 Android 如 何 使 用 HttpURLConnection 访问 网 络 资源 。 


10.2.1 使 用 HttpURLConnection 


使 用 HttpURLConnection 能 实现 简单 的 URL 请 求 、 响 应 功能 。HttpURLConnection 
继承 了 URLConnection, 可 以 发 送 和 接收 任何 类 型 和 长 度 的 数据 , 且 不 用 预先 知道 数据 流 
的 长 度 ,可 以 设置 请 求 方式 为 GET 或 POST, 可 以 设置 超时 时 间 。 
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下 面 通过 一 个 实例 来 介绍 Android 利用 HttpURLConnection 访问 网 页 获取 网 络 
图 片 。 

首先 介绍 一 下 该 实例 的 需求 ,该 实例 主要 实现 两 个 目的 : 一 个 是 访问 百度 首页 ,获取 其 
返回 的 html 字符 串 ; 第 二 个 是 访问 给 定 的 URL, 下 载 图片 并 显示 出 来 。 该 应 用 只 需 实现 
一 个 Activity, 其 对 应 布局 为 : 界面 上 方 放 园 一 个 帧 布局 ,该 布局 中 放 园 一 个 TextView 组 
件 用 于 显示 访问 百度 首页 后 所 获取 的 html 字符 串 ,放置 一 个 ImageView 组 件 用 于 显示 从 
网 络 上 下 载 的 图 片 ,界面 底部 从 左 到 右 放 置 两 个 Button 按钮 ,其 中 一 个 用 于 触发 访问 百度 
首页 , 另 一 个 用 于 触发 访问 下 载 网 络 图 片 。 该 界面 布局 比较 简单 , 故 在 此 不 进行 布局 代码 的 
展示 。 

界面 布局 所 对 应 的 Activity 程序 代码 如 下 所 示 : 


package cn. edu. hstc. httpurlconnectiondemo. activity; 


import java. io. BufferedReader; 

import java. io. IOException; 

import java. io. InputStream; 

import java. io. InputStreamReader; 
import java. net. HttpURLConnection; 
import java. net. MalformedURLException; 
import java. net. URL; 


import android. app. Activity; 

import android. graphics. Bitmap; 
import android. graphics. BitmapFactory; 
import android. os. AsyncTask; 

import android. os. Bundle; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget. Button; 

import android. widget. ImageView; 
import android. widget. ProgressBar; 
import android. widget.RelativeLayout; 
import android. widget. TextView; 


public class MainActivity extends Activity ( 
private Button visitWebBtn; 
private Button downImgBtn; 
private TextView showTextView; 
private ImageView showlImageView; 
private String resultString - ""; 
private ProgressBar progressBar; 


private ViewGroup viewGroup; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R. layout.activity main); 
initView(); 
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visitWebBtn. setOnClickListener(new View.OnClickListener() ( 
GOverride 
public void onClick(View v) { 
showImageView. setVisibility(View. GONE); 
showTextView. setVisibility(View. VISIBLE) ; 


Thread visitBaiduThread = new Thread(new VisitWebRunnable()); 


visitBaiduThread. start(); 
try { 
visitBaiduThread. join(); 
if (!resultString.equals("")) ( 
showTextView. setText(resultString); 
) 
} catch (InterruptedException e) ( 
e. printStackTrace(); 


n; 


downInmgBtn. setOnClickListener(new View.OnClickListener() ( 
(QOverride 
public void onClick(View v) ( 
ShowImageView. setVisibility(View. VISIBLE); 
ShowTextView. setVisibility(View. GONE); 


String imgUrl = "http://img. shixiu. net/file/news/fjxw/9909e2eb3cc173f10- 


7afe2b53a5a2c95. jpg"; 
new DownImgAsyncTask(). execute( imgUrl); 


n; 


private void initView() { 
showTextView = (TextView) findViewById(R. id.textview show); 
showlmageView = (ImageView) findViewById(R. id. imagview show); 
downImgBtn = (Button) findViewById(R. id.btn download img); 
visitWebBtn = (Button) findViewById(R. id.btn visit web); 


/** 
* 获取 指定 URL 的 响应 字符 串 
*/ 
private String getURLResponse(String urlString) ( 
HttpURLConnection conn - null; // 连 接 对 象 
InputStream is = null; 
String resultData = ""; 


try { 
URL url = new URL(urlString); //URL 对 象 
conn = (HttpURLConnection) url.openConnection();  //[&JH URL 打开 一 个 链接 
conn. setDoInput(true); // 人 允许 输入 流 , 即 允许 下 载 
conn. setDoOutput(true); // 人 允许 输出 流 , 即 允许 上 传 


conn. setUseCaches( false); // 不 使 用 缓冲 
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conn. setRequestMethod("GET") ; // 使 用 get 请 求 
is = conn.getInputStream(); // 获 取 输 入 流 ,此 时 才 真 正 建立 链接 
InputStreamReader isr = new InputStreamReader(is); 
BufferedReader bufferReader = new BufferedReader(isr); 
String inputLine - ""; 
while ((inputLine = bufferReader.readLine()) != null) ( 
resultData += inputLine + "Wn"; 
) 
) catch (MalformedURLException e) { 
e. printStackTrace(); 
) catch (IOException e) ( 
e. printStackTrace() ; 
) finally ( 
if (is != null)( 
try { 
is.close(); 
) catch (IOException e) ( 
e. printStackTrace(); 


) 
if (conn != null) ( 
conn. disconnect(); 


) 


return resultData; 


) 

[x 
* 从 指定 URL 获取 图 片 
x/ 


private Bitmap getlImageBitmap(String url) ( 

URL imgUrl - null; 

Bitmap bitmap = null; 

try ( 
imgUrl = new URL(url); 
HttpURLConnection conn - (HttpURLConnection) imgUrl. openConnection(); 
conn. setDoInput(true); 
conn. connect() ; 
InputStream is = conn.getInputStream(); 
bitmap = BitmapFactory.decodeStream(is); 
is.close(); 

) catch (MalformedURLException e) ( 
e. printStackTrace() ; 

} catch (IOException e) ( 
e. printStackTrace(); 

} 

return bitmap; 


class VisitWebRunnable implements Runnable { 
@Override 
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public void run() { 
String data = getURLResponse( "http://www. baidu. com/") ; 
resultString - data; 


class DownImgAsyncTask extends AsyncTask < String, Void, Bitmap» ( 
(QOverride 
protected void onPreExecute() { 
super. onPreExecute() ; 
showImageView. setImageBitmap(null); 
showProgressBar(); // 显 示 进 度 条 提示 框 


@Override 

protected Bitmap doInBackground(String... params) { 
Bitmap b = getlImageBitmap(params[0]); 
return b; 


@Override 
protected void onPostExecute(Bitmap result) { 
super. onPostExecute( result); 
if (result != null) { 
dismissProgressBar(); 
ShowImageView. setImageBitmap(result); 


/xx 
* 在 母 布局 中 间 显示 进度 条 
*/ 
private void showProgressBar() { 
progressBar = new ProgressBar(this, null, android. R. attr. progressBarStyleLarge) ; 
RelativeLayout.LayoutParams params = new RelativeLayout. LayoutParams ( 
ViewGroup. LayoutParams. WRAP _ CONTENT, ViewGroup. LayoutParams. WRAP _ 
CONTENT) ; 
params.addRule(RelativeLayout.CENTER IN PARENT, RelativeLayout. TRUE); 
progressBar. setVisibility(View. VISIBLE); 
//Context context = getApplicationContext(); 
viewGroup = (ViewGroup) findViewById(R. id.parent view); 
viewGroup. addView(progressBar, params); 


"m 
* 隐藏 进度 条 
*/ 
private void dismissProgressBar() { 
if (progressBar != null) { 
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progressBar. setVisibility(View. GONE); 
viewGroup. removeView(progressBar); 
progressBar - null; 


) 
代码 文件 : codes\10\10. 2\HttpURLConnectionDemo\cn\edu\hstc\activity\MainActivity. java 
最 后 ,需要 在 AndroidManifest. xml 中 添加 访问 网 络 的 权限 : 


« uses - permission android:name = "android. permission. INTERNET" /> 


从 上 面 的 MainActivity 类 的 实现 代码 可 以 看 出 ,使 用 HttpURLConnection 的 步骤 是 
先 通过 URL 的 openConnection 实例 化 HttpURLConnection 对 象 ,然后 设置 参数 ,注意 此 
时 并 没有 发 生 连 接 。 真 正 发 生 连 接 是 在 获得 流 时 , 即 代 码 文件 中 的 conn. getInputStream 
这 一 代码 行 ,这 一 点 与 TCP Socket 是 一 样 的 。 

将 该 应 用 部 署 在 Android 模拟 器 上 ,分 别 单 击 界面 中 的 访问 百度 的 按钮 以 及 下 载 图片 
按钮 ,运行 效果 如 图 10.4 和 图 10.5 所 示 。 
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«IDOCTYPE html> 

«html»«!--STATUS OK--><head><meta http- 
equiv="Content-Type" content-"text/html; 
charset=utf-8" /><meta http-equiv="Cache- 
control" content="no-cache" /><meta 
name="viewport" content="width=device- 
width,minimum-scale=1.0,maximum- 

scal ,0,user-scalable=no"/><style 
type="text/css">body (margin: 0;text-align: 
center;font-size: 14px;font-family: Arial, 
Helvetica,LiHei Pro Medium;color: 
#262626;}form (position: relative; margin: 
12px 15px 91 px;height: 41px;}img (border: 0}. 
wordWraptmargin-right: 85px; word 
(background-color: &£FFF;border: 1px solid 
3t6EGEGE;color: 4000;font-size: 18px;height: 
27px;padding: 6px;width: 10096;-webkit- 
appearance: none;-webkit-border-radius: 
O;border-radius: 0;).bn (background-color: 
3fFSFSFS; border: 1px solid #787878;font-size: 
16px;font-weight: bold;height: 41 px;letter- 
spacing: -1px;line-height: 41 px;padding: 

0; position: absolute;right: O;text-align: center; 
top: 0;width: 72px;-webkit-appearance: none;- 
webkit-box-si. border-box;box-sizing: 
border-box;-webkit-border-radius: O;border- 
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图 10.4 访问 百度 首页 图 10.5 下 载 网 络 图 片 





















10.2.2 使 用 HttpClient 接口 


10.2. 1 节 介 绍 了 通过 标准 Java 接口 来 实现 Android 应 用 的 联网 操作 。 前 面 只 是 简单 
地 进行 了 网 络 的 访问 ,但 是 在 实际 开发 中 ,可 能 会 运用 到 更 复杂 的 联网 操作 ,例如 处 理 
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Session, Cookie 等 细节 问题 ,Apache 开源 组 织 提供 了 HttpClient 项 目 , 它 对 java. net 中 的 
类 做 了 封装 和 抽象 ,更 适合 在 Android 上 开发 网 络 应 用 。 简 单 来 说 ,HttpClient 就 是 一 个 增 
强 版 的 HttpURLConnection,HttpURLConnection 能 做 的 事情 HttpClient 都 可 以 胜任 ,并 
H. HttpClient 提供 了 HttpURLConnection 所 没有 提供 的 部 分 功能 。Android 已 经 成 功 地 
集成 了 HttpClient, 这 意味 着 开发 人 员 可 以 直接 在 Android 应 用 中 使 用 HttpClient 来 访问 
提交 请 求 .接收 响应 。 要 使 用 HttpClient ,需要 了 解 下 面 一 些 接口 和 类 。 


1. ClientConnectionManager 接口 


ClientConnectionManager 是 客户 端 连 接管 理 器 接口 , 它 提供 几 个 抽象 方法 ,如 表 10. 3 





所 示 。 
表 10.3 ClientConnectionManager 的 抽象 方法 
方 法 名 描 xk 
voidcloseExpiredConnections 关闭 所 有 无 效 .超时 的 连接 
voidcloseldleConnections(long idletime, TimeUnit tunit) 关闭 空闲 的 连接 


voidreleaseConnection ( HttpClientConnection conn. Object newState，long 释放 一 个 连接 
validDuration, TimeUnit timeUnit) 

ConnectionRequest requestConnection( HttpRoute route, Object state) 请 求 一 个 新 的 连接 
voidshutdown() 关闭 管理 器 并 释放 资源 


2. DefaultHttpClient 


DefaultHttpClient 是 默认 的 一 个 HTTP 客户 端 ,可 以 使 用 它 创 建 一 个 HTTP 连接 。 
代码 如 下 : 


HttpClient httpClient = new DefaultHttpClient(); 


3. HttpResponse 


HttpResponse 是 一 个 HTTP 连接 响应 , 当 执 行 一 个 HTTP 连接 后 ,就 会 返回 一 个 
HttpResponse, 可 以 通过 HttpResponse 获得 一 些 响应 的 信息 。 下 面 是 请 求 一 个 HTTP 连 
接 并 获得 该 请 求 是 否 成 功 的 代码 。 

HttpResponse httpResponse = httpClient. execute(httpRequest); 

If (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC OK) { 


// 连 接 成 功 
} 


通过 上 面 几 个 类 和 接口 的 了 解 , 下 面 运用 上 面 的 知识 来 实现 一 个 从 服务 端 获 取 通 讯 录 
信息 的 应 用 ,该 应 用 的 代码 实现 中 既 使 用 了 Get 的 请 求 方式 ,也 使 用 了 Post 的 请 求 方式 。 

首先 ,为 了 在 项 目 中 更 方便 地 使 用 HttpClient 以 及 使 该 部 分 代码 可 以 重用 ,需要 实现 
一 个 名 为 HttpUtil 的 工具 类 ,在 该 工具 类 中 实现 了 Android 使 用 HttpClient 访问 网 络 获取 
数据 的 核心 程序 ,该 工具 类 源码 如 下 : 
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package cn. edu. hstc. httpclientdemo. util; 


import java. io. IOException; 
import java. util.List; 


import org. apache. http. HttpEntity; 

import org. apache. http. HttpResponse; 

import org. apache. http. HttpStatus; 

import org. apache. http. NameValuePair; 

import org. apache. http. client. ClientProtocolException; 
import org. apache. http. client.HttpClient; 

import org. apache. http. client. entity. UrlEncodedFormEntity; 
import org. apache. http. client. methods. HttpGet; 

import org. apache. http. client. methods.HttpPost; 

import org. apache. http. impl.client.DefaultHttpClient; 
import org. apache. http. util. EntityUtils; 


public class HttpUtil { 


public static final String BASE URL = "http://192.168.1.100:8080/ydContacts/servlet/"; 


public static String getDataByGet(String url) ( 
String resultString - ""; 
try { 
// 得 到 HttpClient Xj 
HttpClient getClient = new DefaultHttpClient(); 
// 得 到 HttpGet X 
HttpGet request = new HttpGet(url); 
// 客 户 端 使 用 Get 方式 执行 请 求 , 获得 服务 器 端的 回应 response 
HttpResponse response = getClient. execute( request) ; 
// 判 断 请 求 是 否 成 功 
if (response.getStatusLine().getStatusCode() == HttpStatus.SC OK) ( 
resultString = EntityUtils.toString(response. getEntity()); 
) eise ( 
resultString 


"请 求 服务 器 发 生 错 误 !"; 
} 

} catch (ClientProtocolException e) { 
System. out. println(e. getMessage( ). toString()); 
resultString = "请 求 服务 器 异常 !"; 

} catch (IOException e) { 
System. out. println(e. getMessage( ). toString()); 
resultString = "请 求 服务 器 异常 !"; 

} catch (Exception e) { 
System. out. println(e.getMessage().toString()); 
resultString = "请 求 服务 器 异常 !"; 

} 


return resultString; 


public static String getDataByPost(String url, List < NameValuePair > params) { 
String resultString - ""; 
try { 
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HttpClient client = new DefaultHttpClient(); 

HttpPost request - new HttpPost(url); 

// 实 例 化 UrlEncodedFormEntity 对 象 并 设置 字符 集 

HttpEntity entity = new UrlEncodedFormEntity(params, "gb2312"); 
// 使 用 BttpPost 对 象 来 设置 UrlEncodedFormEntity 的 Entity 
request. setEntity(entity); 

HttpResponse response = client. execute( request); 


if (response.getStatusLine().getStatusCode() == HttpStatus.SC OK) ( 
resultString = EntityUtils. toString(response. getEntity()); 
) else ( 


resultString = "请 求 服务 器 发 生 错 误 !"; 
) 
) catch (ClientProtocolException e) ( 


System. out. println(e.getMessage().toString()); 
resultString = "WORT SERE"; 

) catch (IOException e) ( 
System. out. println(e.getMessage().toString()); 
resultString = "请 求 服务 器 异常 !"; 

} catch (Exception e) { 
System. out. println(e. getMessage(). toString()); 
resultString = "请 求 服务 器 异常 1"; 

return resultString; 


代码 文件 : codes\10\10.2\HttpClientDemo\cn\edu\hstc\util\HttpUtil. java 


上 面 的 程序 实现 了 使 用 HttpClient 发 送 Get 请 求 以 及 Post 请 求 ,并 且 获 取 响 应 数据 的 
核心 功能 ,因此 以 上 工具 类 的 代码 实现 是 本 节 的 掌握 重点 。 

由 于 该 应 用 中 获取 的 通讯 录 数 据 是 显示 在 一 个 ListView 组 件 中 ,并 且 该 ListView 需 
要 实现 下 拉 刷 新 以 及 上 拉 加 载 更 多 的 功能 ,达到 ListView 分 页 效果 ,因此 需要 自 定 义 自己 
的 List View 基 类 ,而 该 基 类 集成 了 下 拉 刷 新 以 及 上 拉 加 载 更 多 的 功能 ,在 其 他 Android 项 
目 中 ,可 以 对 该 基 类 进行 复 用 ,该 基 类 代码 如 下 : 





package cn. edu. hstc. httpclientdemo. util; 


import android. content. Context; 

import android. util.AttributeSet; 

import android. view. MotionEvent; 

import android. view. View; 

import android. view. ViewTreeObserver. OnGlobalLayoutListener; 
import android. view. animation. DecelerateInterpolator; 
import android. widget. AbsListView; 

import android. widget. AbsListView. OnScrollListener; 
import android. widget. ListAdapter; 

import android. widget. ListView; 

import android. widget. RelativeLayout; 

import android. widget. Scroller; 

import android. widget. TextView; 

import cn. edu. hstc. httpclientdemo. activity. R; 
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public class RefreshListView extends ListView implements OnScrollListener { 
private float mLastY - -1; 
private Scroller mScroller; 
private OnScrollListener mScrollListener; 
private ListViewListener mListViewListener; 


private ListViewHeader mHeaderView; //header view 
private RelativeLayout mHeaderViewContent; 
private TextView mHeaderTimeView; 


private int mHeaderViewHeight; / header view's height 
private boolean mEnablePullRefresh - true; 

private boolean mPullRefreshing - false; //is refreashing. 
private ListViewFooter mFooterView; //£ooter view 


private boolean mEnablePullLoad; 
private boolean mPullLoading; 
private boolean mEnableAutoload - true; 


private int mTotalltemCount; 


private int mScrollBack; 
private final static int SCROLLBACK HEADER - 0; 


private final static int SCROLL DURATION - 400; //scroll back duration 
private final static float OFFSET RADIO - 1.8f; //support iOS like pull 
private int total; // 列 表 项 总 数 


public RefreshListView(Context context) { 
super(context); 
initWithContext(context); 


public RefreshListView(Context context, AttributeSet attrs) { 
super(context, attrs); 
initWithContext(context); 


public RefreshListView(Context context, AttributeSet attrs, int defStyle) ( 
super(context, attrs, defStyle); 
initWithContext(context); 


private void initWithContext(Context context) ( 
mScroller = new Scroller(context, new DecelerateInterpolator()); 
super. setOnScrollListener(this); 


mHeaderView - new ListViewHeader(context); 

mHeaderViewContent = (RelativeLayout) mHeaderView. findViewById(R. id. xlistview | 
header content); 

mHeaderTimeView = (TextView) mHeaderView.findViewById(R. id. xlistview header time); 
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addHeaderView(mHeaderView); 


mFooterView - new ListViewFooter(context); 
mFooterView. getLoadmore().setOnClickListener(new OnClickListener() { 
(QOverride 
public void onClick(View v) ( 
startLoadMore(); 


np; 


mHeaderView. getViewTreeObserver ( ) . addOnGlobalLayoutListener(new OnGlobalLayoutListener() { 
(QOverride 
public void onGlobalLayout() ( 
mHeaderViewHeight - mHeaderViewContent.getHeight(); 
getViewTreeObserver(). removeGlobalOnLayoutListener(this); 


public void setTotal(int total) { 
this.total - total; 


public boolean pullRefreshing() ( 
return mPullRefreshing; 


public boolean pullLoading() ( 
return mPullLoading; 


@Override 
public void setAdapter(ListAdapter adapter) { 
addFooterView(mFooterView); 
super. setAdapter(adapter); 
if (adapter.getCount() == total) ( 
removeFooterView(mFooterView); 


public void setPullRefreshEnable(boolean enable) { 
mEnablePullRefresh = enable; 


if (!mEnablePullRefresh) { //disable, hide the content 
mHeaderViewContent. setVisibility(View. INVISIBLE); 
} else { 


mHeaderViewContent. setVisibility(View. VISIBLE); 


public void setPullLoadEnable(boolean enable) { 
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mEnablePullLoad = enable; 
mFooterView. setOnClickListener(null); 
if (!mEnablePullLoad) { 
mFooterView.hide(); 
} else { 
mPullLoading = false; 
mFooterView. show( ); 
if (!mEnableAutoload) { 
mFooterView.setState(ListViewFooter. STATE BUTTON); 
) else ( 
mFooterView.setState(ListViewFooter. STATE NORMAL); 


public void sethutoLoad(boolean enable) ( 
mEnableAutoload = enable; 
if (!mPullLoading) { 
if (!mEnableAutoload) ( 
mFooterView.setState(ListViewFooter. STATE BUTTON); 
) eise ( 
mFooterView.setState(ListViewFooter. STATE NORMAL); 


public void stopRefresh() ( 
if (mPullRefreshing == true) { 
mPullRefreshing = false; 
resetHeaderHeight(); 


public void stopLoadMore() ( 
if (mPullLoading == true) { 
mPullLoading = false; 
if (!mEnableAutoload) ( 
mFooterView.setState(ListViewFooter. STATE BUTTON); 
) else ( 
mFooterView.setState(ListViewFooter. STATE NORMAL); 


public void setRefreshTime(String time) ( 
mHeaderTimeView.setText(time); 


public String getRefreshTime() { 
return mHeaderTimeView. getText().toString(); 
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private void invokeOnScrolling() ( 
if (mScrollListener instanceof OnXScrollListener) ( 
OnXScrollListener l - (OnXScrollListener) mScrollListener; 
l.onXScrolling(this); 


private void updateHeaderHeight(float delta) ( 
mHeaderView.setVisiableHeight((int) delta + mHeaderView.getVisiableHeight()); 
if (mEnablePullRefresh && !mPullRefreshing) { // 未 处 于 刷新 状态 ,更 新 箭头 
if (mHeaderView. getVisiableHeight() > mHeaderViewHeight) { 
mHeaderView. setState(ListViewHeader. STATE READY); 
) eise ( 
mHeaderView.setState(ListViewHeader. STATE NORMAL); 


) 


setSelection(0); //scroll to top each time 


private void resetHeaderHeight() { 
int height = mHeaderView.getVisiableHeight(); 
if (height -- 0) //not visible. 
return; 
//refreshing and header isn't shown fully. do nothing. 
if (mPullRefreshing && height < = mHeaderViewHeight) ( 
return; 
) 
int finalHeight = 0; //default: scroll back to dismiss header. 
//is refreshing, just scroll back to show all the header. 
if (mPullRefreshing && height > mHeaderViewHeight) { 
finalHeight - mHeaderViewHeight; 
) 
mScrollBack - SCROLLBACK HEADER; 
mScroller.startScroll(0, height, 0, finalHeight - height, SCROLL DURATION); 
//trigger computeScroll 
invalidate(); 


private void startLoadMore() ( 
mPullLoading - true; 
mFooterView. setState(ListViewFooter. STATE LOADING); 
if (mListViewListener != null) { 
mListViewListener. onLoadMore(); 


} 

} 

@Override 

public boolean onTouchEvent (MotionEvent ev) { 
if (mLastY == -1)( 


mLastY = ev.getRawY(); 
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switch (ev. getAction()) { 
case MotionEvent. ACTION DOWN: 
mLastY = ev.getRawY(); 
break; 
case MotionEvent. ACTION MOVE: 
final float deltaY = ev.getRawY() - mLastY; 
mLastY = ev.getRawY(); 
if (getFirstVisiblePosition() == 0 && (mHeaderView.getVisiableHeight() > 0 || 
deltaY > 0)) ( 
//the first item is showing, header has shown or pull down. 
updateHeaderHeight(deltaY / OFFSET RADIO); 


invokeOnScrolling(); 
) 
break; 
default: 
mLastY --1; //reset 


if (getFirstVisiblePosition() == 0) { 
//invoke refresh 
if (mEnablePullRefresh && mHeaderView.getVisiableHeight() > mHeaderViewHeight) { 
mHeaderView. setState(ListViewHeader. STATE REFRESHING); 
if (mListViewListener != null && !mPullRefreshing) ( 
mPullRefreshing = true; 
mListViewListener. onRefresh(); 


) 
resetHeaderHeight(); 


) 


break; 
) 
return super. onTouchEvent(ev) ; 
) 
(QOverride 


public void computeScroll() ( 
if (mScroller.computeScrollOffset()) ( 
if (mScrollBack -- SCROLLBACK HEADER) ( 
mHeaderView. setVisiableHeight(mScroller.getCurrY()); 
) else ( 
mFooterView. setBottomMargin(mScroller.getCurrY()); 


) 
postInvalidate(); 
invokeOnScrolling(); 
} 
super. computeScroll(); 
) 
(QOverride 


public void setOnScrollListener(OnScrollListener 1) ( 
mScrollListener = 1; 
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@Override 
public void onScrollStateChanged(AbsListView view, int scrollState) { 
if (mScrollListener != null) { 
mScrollListener. onScrollStateChanged(view, scrollState); 


if (scrollState -- SCROLL STATE TOUCH SCROLL) ( 
int totalCount - 0; // 内 容 列表 数 
if (getFooterViewsCount() > 0) 
totalCount = mTotalltemCount - 2; 
else 
totalCount = mTotalltemCount - 1; 
if (mTotalltemCount » 0 && totalCount « total) ( 
if (getFooterViewsCount() == 0) { 
addFooterView(mFooterView); 
) 
) else ( 
if (getFooterViewsCount() » 0) 
removeFooterView(mFooterView); 


(QOverride 
public void onScroll(AbsListView view, int firstVisibleItem, int visibleltemCount, int 
totalltemCount) ( 
/ / send to user's listener 
mTotalltemCount - totalltemCount; 
if (mScrollListener !- null) { 
mScrollListener.onScroll(view, firstVisibleltem, visibleltemCount, totalltemCount); 


if (getLastVisiblePosition ( ) = = mTotalltemCount - 1 && ! mPullLoading && 
getFooterViewsCount() » 0) ( 
if (mEnableAutoload) ( 
startLoadMore(); 


public void setListViewListener(ListViewListener 1) { 


mListViewListener = 1; 


public interface OnXScrollListener extends OnScrollListener ( 
public void onXScrolling(View view); 


public interface ListViewListener { 
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public void onRefresh(); 


public void onLoadMore(); 


代码 文件 : codes\10\10.2\HttpClientDemo\cn\edu\hstc\util\ RefreshListView. java 


上 面 RefreshListView 类 继承 自 ListView 基 类 ,实现 OnScrollListener 接口 ,实现 自 定 
义 的 下 拉 刷 新 以 及 上 拉 加 载 更 多 的 功能 。 当 用 户 下 拉 ListView 列表 时 ,将 会 在 ListView 
的 顶部 出 现 *“ 下 拉 可 以 刷新 ”的 提示 , 当 用 户 松手 时 ,将 会 在 顶部 出 现 * 正 在 加 载 …” 的 提示 ， 
当 用 户 上 拉 ListView 列表 时 ,将 会 在 底部 提示 “正在 加 载 中 …”, 因 此 ,需要 对 ListView 的 
顶部 和 底部 进行 特殊 处 理 , 分 别 新 建 两 个 布局 类 来 代表 该 ListView 的 顶部 和 底部 ,顶部 的 
代表 类 为 ListViewHeader, 该 类 源码 如 下 : 


package cn. edu. hstc. httpclientdemo. util; 


import android. content. Context; 

import android. util. AttributeSet; 

import android. view. Gravity; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. animation. Animation; 
import android. view. animation. RotateAnimation; 
import android. widget. ImageView; 

import android. widget.LinearLayout; 

import android. widget.ProgressBar; 

import android. widget. TextView; 

import cn. edu. hstc. httpclientdemo. activity. R; 


public class ListViewHeader extends LinearLayout { 
private LinearLayout mContainer; 
private ImageView mArrowlmageView; 
private ProgressBar mProgressBar; 
private TextView mHintTextView; 
private int mState = STATE NORMAL; 


private Animation mRotateUpAnim; 
private Animation mRotateDownAnim; 


private final int ROTATE ANIM DURATION - 180; 


public final static int STATE NORMAL - 0; 
public final static int STATE READY - 1; 
public final static int STATE REFRESHING - 2; 


public ListViewHeader(Context context) { 
super(context); 
initView(context); 
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public ListViewHeader(Context context, AttributeSet attrs) { 
super(context, attrs); 
initView(context); 


private void initView(Context context) { 
// 初 始 情况 ,设置 下 拉 刷 新 view 高 度 为 0 
LinearLayout. LayoutParams lp = new LinearLayout. LayoutParams (android. view. 
ViewGroup.LayoutParams.MATCH PARENT, 0); 
mContainer = (LinearLayout) LayoutInflater. from (context). inflate (R. layout. 
xlistview header, null); 
addView(mContainer, lp); 
setGravity(Gravity. BOTTOM); 


mArrowImageView = (ImageView) findViewById(R. id. xlistview header arrow); 
mHintTextView - (TextView) findViewById(R. id.xlistview header hint textview); 
mProgressBar = (ProgressBar) findViewById(R. id.xlistview header progressbar); 


mRotateUpAnim = new RotateAnimation(0. 0f, ~ 180.0f, Animation. RELATIVE TO SELF, 
0.5f, Animation. RELATIVE TO SELF, 0.5f); 

mRotateUpAnim. setDuration(ROTATE ANIM DURATION); 

mRotateUpAnim. setFillAfter(true); 

mRotateDownAnim = new RotateAnimation( — 180.0f, 0.0f, Animation. RELATIVE TO SELF, 
0.5f, Animation. RELATIVE TO SELF, 0.5f); 

mRotateDownAnim. setDuration(ROTATE ANIM DURATION); 

mRotateDownAnim. setFillAfter(true); 


public void setState(int state) { 
if (state == mState) 
return; 


if (state -- STATE REFRESHING) { // 显 示 进 度 
mArrowImageView. clearAnimation(); 
mArrowImageView. setVisibility(View. INVISIBLE); 
mProgressBar. setVisibility(View. VISIBLE); 

) else ( // 显 示 箭 头 图 片 
mArrowImageView. setVisibility(View. VISIBLE); 
mProgressBar.setVisibility(View. INVISIBLE); 


switch (state) ( 
case STATE NORMAL: 
if (mState -- STATE READY) ( 
mArrowImageView. startAnimation(mRotateDownAnim); 








) 

if (mState == STATE REFRESHING) [ 
mArrowImageView.clearAnimation(); 

) 

nHintTextView. setText(" 下 拉 可 以 刷新 ") ; 

break; 
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case STATE READY: 
if (mState !- STATE READY) ( 
mArrowImageView.clearAnimation(); 
mArrowImageView.startAnimation(mRotateUpAnim); 
nHintTextView. setText(" 松 开 可 以 刷新 "); 
} 
break; 
Case STATE REFRESHING: 
mHintTextView. setText(" 正 在 加 载 .…"); 
break; 
default: 
break; 


mState - state; 


public void setVisiableHeight(int height) { 
if (height « 0) 
height - 0; 
LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) mContainer. 
getLayoutParams(); 
lp.height - height; 
mContainer. setLayoutParams(1lp); 


public int getVisiableHeight() ( 
return mContainer.getHeight(); 


) 
代码 文件 : codes\10\10.2\HttpClientDemo\cn\edu\hstc\util\ ListViewHeader. java 


接着 ,需要 实现 自 定义 ListView 的 底部 代表 类 ,该 类 命名 为 ListViewFooter ,该 类 源码 
如 下 : 


package cn. edu. hstc. httpclientdemo. util; 


import android. content. Context; 

import android. util. AttributeSet; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. widget.Button; 

import android. widget.LinearLayout; 

import android. widget. TextView; 

import cn. edu. hstc. httpclientdemo. activity. R; 


public class ListViewFooter extends LinearLayout { 
public final static int STATE NORMAL - 0; 
public final static int STATE LOADING - 1; 
public final static int STATE BUTTON - 2; 
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private Context mContext; 


private View mContentView; 
private View mProgressBar; 
private TextView mHintView; 
private Button btn loadmore; 


public ListViewFooter(Context context) { 
super(context); 
initView(context); 


public ListViewFooter(Context context, AttributeSet attrs) { 
super(context, attrs); 
initView(context); 


public void setState(int state) { 

if (state -- STATE NORMAL) ( 
btn loadmore. setVisibility(View. GONE); 
mProgressBar. setVisibility(View. GONE); 
mHintView.setVisibility(View. VISIBLE); 
nHintView. setText(" 查 看 更 多 "); 

} else if (state == STATE LOADING) { 
btn_loadmore. setVisibility(View. GONE); 
mProgressBar. setVisibility(View. VISIBLE); 
mHintView.setVisibility(View. VISIBLE); 
nHintView. setText(" 正 在 加 载 中 .…"); 

} else if (state == STATE BUTTON) { 
mProgressBar. setVisibility(View. GONE); 
mHintView.setVisibility(View. GONE); 
btn loadmore. setVisibility(View. VISIBLE); 








public void setBottomMargin(int height) ( 
if (height « 0) 
return; 
LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) mContentView. 
getLayoutParans(); 
lp.bottomMargin = height; 
mContentView. setLayoutParams(lp); 


public int getBottomMargin() ( 
LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) mContentView. 
getLayoutParans(); 
return lp. bottomMargin; 


public void normal() ( 
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mHintView. setVisibility(View. VISIBLE); 
mProgressBar. setVisibility(View.GONE); 


public void loading() { 
mHintView. setVisibility(View. GONE); 
mProgressBar.setVisibility(View. VISIBLE); 


public void hide() ( 
LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) mContentView. 
getLayoutParams(); 
lp.height = 0; 
mContentView. setLayoutParams(lp); 


public void show() ( 
LinearLayout.LayoutParams lp = (LinearLayout.LayoutParams) mContentView. 
getLayoutParams(); 
lp.height = android. view. ViewGroup. LayoutParams. WRAP CONTENT; 
mContentView. setLayoutParams(lp); 


public Button getLoadmore() ( 
return btn loadmore; 


private void initView(Context context) { 
mContext = context; 
LinearLayout moreView = (LinearLayout) LayoutInflater. from(mContext). inflate (R. 
layout.xlistview footer, null); 
addView(moreView); 
moreView. setLayoutParams(new LinearLayout. LayoutParams (android. view. ViewGroup. 
LayoutParams.MATCH PARENT, android. view. ViewGroup. LayoutParams.WRAP CONTENT)); 


mContentView = moreView.findViewById(R. id.xlistview footer content); 
mProgressBar = moreView.findViewById(R. id.xlistview footer progressbar); 
mHintView = (TextView) moreView.findViewById(R. id.xlistview footer hint 
textview); 

btn loadmore = (Button) moreView. findViewById(R. id.btn loadmore); 


代码 文件 : codes\10\10.2\HttpClientDemo\cn\edu\hstc\util\ ListViewFooter. java 


上 面 所 实现 的 List View 组 件 的 自 定义 顶部 以 及 底部 都 有 对 应 的 布局 代码 ,首先 ,实现 
顶部 布局 类 ListViewHeader 所 对 应 的 布局 文件 ,其 源码 如 下 : 


<?xml version = "1.0" encoding = "utf - 8"?> 

« LinearLayout xmlns:android = "http://schemas.android. con/apk/res/android" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
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android:background = "@android:color/white" 
android:gravity = "bottom" > 


< RelativeLayout 
android:id="@ + id/xlistview header content" 
android:layout width- "fill parent" 
android:layout height = "60dp" > 





< LinearLayout 
android:id- "(à + id/xlistview header text" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout centerInParent = "true" 
android:gravity = "center" 
android:orientation = "vertical" » 


< TextView 
android: id = "(2 + id/xlistview header hint textview" 
android:layout width = "wrap content" 
android:layout height - "wrap content" 


android: text = "下 拉 可 以 刷新 ”/> 


< LinearLayout 
android: layout_width = "wrap content" 
android:layout height = "wrap content" 
android:layout marginTop = "3dp" > 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:text = "更 新 于 : " 
android:textSize = "12sp" /> 


< TextView 
android:id- "(à + id/xlistview header time" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:textSize = "12sp" /> 
«/LinearLayout > 
«/LinearLayout > 


< ImageView 
android:id- "@ + id/xlistview header arrow" 
android:layout width = "20dp" 
android:layout height = "wrap content" 
android:layout alignLeft = "(Zid/xlistview header text" 
android:layout centerVertical - "true" 
android:layout marginLeft - " — 35dp" 
android: src = "(drawable/xlistview arrow" /> 


< ProgressBar 


android 


android 


android 
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:id- "(Q + id/xlistview header progressbar" 
android: 
android: 
:layout alignLeft = "(Qid/xlistview header text" 
android: 
android: 


layout width = "20dp" 
layout height - "20dp" 


layout centerVertical = "true" 
layout marginLeft - " — 40dp" 


:visibility = "invisible" /> 


«/RelativeLayout > 


«/LinearLayout > 


代码 文件 : 
ListView 自 定义 底 


<?xml version = "1.0" 
<LinearLayout xmlns: 


codes\10\10. 2\HttpClientDemo\res\layout\ xlistview header.xml 
部 布局 文件 如 下 : 


encoding = "utf - 8"?> 
android = "http://schemas. android. com/apk/res/android" 


android:layout width= "fill parent" 


android:layout height = "wrap content" 
android:background = "(2 android:color/white"» 


< RelativeLayout 
:id= 





androi 


"(à + id/xlistview footer content" 


android:layout width = "fill parent" 
android:layout height = "wrap content" 


android: padding 





"20dp" 


android:gravity = "center"> 


< ProgressBar 


android: 
android: 
android: 
android: 


android 


< TextView 


android: 
android: 
android: 
android: 


android 


android: 
android: 


android 


< Button 


android: 
android: 
android: 
android: 


android 
android 


id= "@ + id/xlistview_footer_progressbar" 
layout_width = "20dp" 

layout_height = "20dp" 

layout_marginRight = "10dp" 

:visibility= "gone" /> 


id= "@ + id/xlistview footer hint textview" 

layout width- "wrap content" 

layout height = "wrap content" 

layout toRightOf = "(Z2id/xlistview footer progressbar" 
:text = "查看 更 多 " 

textColor = "@android:color/black" 

textSize = "18sp" 

:layout_centerVertical = "true" /> 


id="@ + id/btn loadmore" 

layout width- "fill parent" 

layout height = "wrap content" 

text = "查看 更 多 " 

:textColor = "@android:color/black" 
:textSize= "18sp" 
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android:visibility = "gone"/> 
</RelativeLayout > 


</LinearLayout > 
代码 文件 : codes\10\10.2\HttpClientDemo\res\layout\ xlistview footer.xml 


当然 ,既然 项 目 中 运用 到 了 ListView 组 件 ,必定 需要 为 该 ListView 组 件 的 每 个 列表 项 
定义 其 布局 ,在 本 应 用 中 ,ListView 列表 项 的 布局 如 下 : 


<?xml version = "1.0" encoding = "utf - 8"?> 
< RelativeLayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android: layout width= "match parent" 
android: layout height = "match parent" 
android:paddingBottom = "2dp" 
android:paddingLeft = "20dp" 
android:paddingRight - "20dp" 
android:paddingTop = "2dp" > 


< TextView 
android:id- "(9 * id/txt name" 
android:layout width = "wrap content" 
id:layout height = "wrap content" 
id:layout alignParentLeft - "true" 
android:layout centerVertical = "true" /> 





« TextView 
android:id- "@ + id/txt ge" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout centerVertical- "true" 
android:layout toRightOf = "(2id/txt name" 
android:text = "(" /> 


< TextView 
android:id- "@ + id/txt department" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout centerVertical = "true" 
android:layout toRightOf = "(2id/txt ge" /> 


< TextView 
id:id- "(à + id/txt gel" 
id:layout width = "wrap content" 
id:layout height = "wrap content" 
layout centerVertical = "true" 
id:layout toRightOf = "(8id/txt department" 
id:text = ")" /> 





< ImageView 
android:id- "(2 + id/image icon" 
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android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:layout alignParentRight - "true" 
android:layout centerVertical- "true" 
android:background = "(Qdrawable/right icon" /> 


«/RelativeLayout > 
代码 文件 : codes\10\10.2\HttpClientDemo\res\layout\listview_ item.xml 


项 目 中 使 用 了 ListView, 必 定 需要 加 载 数 据 源 ,因此 ,需要 自 定义 List View 的 数据 适 
配器 MyListViewAdapter, 源 码 如 下 : 


package cn. edu. hstc. httpclientdemo. util; 


import java.util.ArrayList; 
import java.util.List; 


import org. json. JSONObject; 


import android. content. Context; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget. BaseAdapter; 

import android. widget. TextView; 

import cn. edu. hstc. httpclientdemo. activity. R; 


public class MyListViewAdapter extends BaseAdapter { 
private List « JSONObject» list = new ArrayList < JSONObject >(); 
private LayoutInflater inflater; 


// 在 构造 器 中 注 和 数据 源 
public MyListViewAdapter(Context context, List < JSONObject > list) ( 
this.list - list; 
inflater = (LayoutInflater) context. getSystemService (Context. LAYOUT  INFLATER _ 
SERVICE) ; 
) 


(QOverride 
public int getCount() ( 
return list.size(); 


(GOverride 
public Object getItem( int position) ( 
return list.get(position); 


(QOverride 
public long getItemId(int position) ( 
return position; 
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) 


// 自 定义 列表 项 
@Override 
public View getView(int position, View convertView, ViewGroup parent) { 
ViewHolder holder = null; 
if (convertView == null) { 
// 加 载 列表 项 布局 文件 
convertView = inflater.inflate(R.layout.listview item, null); 
holder = new ViewHolder(); 


holder. name = (TextView) convertView. findViewById(R. id.txt name); 
holder. department = (TextView) convertView.findViewById(R. id. txt department); 


convertView. setTag( holder); 
) eise ( 
holder = (ViewHolder) convertView.getTag(); 


) 
holder. name. setText(list.get(position).optString("name")); 


holder. department. setText(list.get(position).optString("department")); 


return convertView; 


public static class ViewHolder ( 
public TextView name; 
public TextView department; 


代码 文件 : codes\10\10.2\HttpClientDemo\cn\edu\hstc\\util\ MyListViewAdapter. java 


应 用 一 启动 ,将 会 向 服务 器 端 请 求 数据 ,而 这 需要 经 过 一 定 的 时 间 段 ,在 该 时 间 内 ,如 果 
在 界面 中 没有 任何 提示 ,将 会 大 大 降低 应 用 的 用 户 体验 ,此 时 ,需要 借助 一 个 对 话 框 来 提示 


用 户 数 据 正 在 加 载 中 ,该 对 话 框 对 应 的 布局 文件 如 下 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 
< LinearLayout xmlns:android = "http://schemas.android. com/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 
android:gravity = "center" 
android:padding = "10dp" > 


< ProgressBar 

android: layout_width = "wrap content" 
layout_height = "wrap_content" 
:layout_marginLeft = "10dp" 
android:layout_marginRight = "10dp" /> 






< TextView 
android: id= "(9 + id/message" 
android: layout_width = "wrap content" 
android:layout height = "wrap content" 
android:layout marginRight = "10dp" 
android:textColor = "(Sandroid:color/white" /> 
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</LinearLayout > 


代码 文件 : codes\10\10.2\HttpClientDemo\res\layout\ dialog_prompt. xml 


接着 , 自 定义 一 个 对 话 框 工具 类 来 加 载 上 面 的 布局 文件 ,生成 一 个 AlertDialog 对 话 框 ， 
该 工具 类 将 会 在 实现 软件 Activity 时 使 用 到 , 当 Activity 生成 时 ,利用 该 工具 类 返回 一 个 对 
话 框 ,以 提示 用 户 数 据 加 载 中 ,改进 用 户 体 验 。 该 工具 类 源码 如 下 : 


package cn. edu. hstc. httpclientdemo. util; 


import android. app. Activity; 

import android. app. AlertDialog; 

import android. widget. LinearLayout; 

import android. widget. TextView; 

import cn. edu. hstc. httpclientdemo. activity. R; 


public class DialogUtil { 
public static AlertDialog prompt(Activity context, String content) { 
AlertDialog. Builder builder = new AlertDialog. Builder(context); 
LinearLayout layout = (LinearLayout) context.getLayoutInflater(). inflate(R. layout. 
dialog prompt, null); 
((TextView) layout. findViewById(R. id. message) ) . setText(content); 
builder. setView(layout); 
AlertDialog dialog = builder.show(); 
dialog. setCanceledOnTouchOutside(false); 
return dialog; 


代码 文件 : codes\10\10.2\HttpClientDemo\cn\edu\hstc\httpclientdemo\util\DialogUtil. java 


完成 了 以 上 的 一 些 基础 支撑 类 的 创建 后 ,就 可 以 进入 应 用 的 界面 实现 部 分 了 ,本 应 用 只 
有 一 个 用 户 界面 ,该 界面 作为 应 用 的 启动 界面 ,软件 一 启动 便 加 载 ,然后 在 该 Activity 中 请 
求 后 台 获 取 数 据 ,并 填充 在 自 定义 的 ListView 组 件 中 。 该 Activity 所 对 应 的 布局 代码 
WTF: 


< LinearLayout xmlns :android = "http://schemas. android. com/apk/res/android" 
android: id= "(9 + id/content" 
android:layout width = "match parent" 
android:layout height - "match parent" 
android:orientation = "vertical" » 


< RelativeLayout 

id="@ + id/layout list" 

ayout width- "fill parent" 
android:layout height = "wrap content" 
android:background = "(Z2 color/gainsboro" 
android:padding = "10dp" > 





< TextView 
android:layout width- "wrap content" 
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android:layout height = "wrap content" 

android:layout centerInParent - "true" 

android:text = "通讯 录 " 

android:textSize = "22sp" /> 
</RelativeLayout > 


</LinearLayout > 
代码 文件 : codes\10\10.2\HttpClientDemo\res\layout\activity main. xml 


上 面 提 到 过 ,在 应 用 的 启动 界面 中 ,将 实现 向 特定 的 后 台 请 求 数 据 并 显示 在 ListView 
组 件 中 ,那么 ,该 Activity 类 就 实现 了 使 用 HttpClient 访问 网 络 数据 的 功能 。 也 就 是 说 ,在 
该 Activity 类 中 ,将 会 调用 一 开始 就 已 经 实现 好 的 HttpUtil 工具 类 中 的 两 个 方法 ,使 用 
HttpClient 发 送 Get 请 求 或 Post 请 求 并 获得 HTTP 响应 数据 。 通 常 ,需要 将 与 服务 端 交 
互 的 实现 放 在 一 个 线程 中 去 执行 ,而 Android 提供 了 封装 良好 的 AsyncTask 机 制 ， 
AsyncTask 允许 在 后 台 执行 一 个 异步 任务 ,因此 可 以 将 耗 时 的 操作 放 在 异步 任务 当中 来 执 
行 , 并 随时 将 任务 执行 的 结果 返回 给 UI 线程 来 更 新 UI 控件 。 因 此 ,只 需要 在 AsyncTask 
实现 HttpClient 访问 后 台数 据 并 通知 ListView 组 件 更 新 数据 源 即 可 。 

iE Activity 类 的 实现 代码 如 下 : 


package cn. edu. hstc. httpclientdemo. activity; 


import java. text. SimpleDateFormat; 
import java. util. ArrayList; 

import java. util. Date; 

import java. util. List; 


import org. apache. http. NameValuePair; 

import org. apache. http. message. BasicNameValuePair; 
import org. json. JSONArray; 

import org. json. JSONObject; 


import android. app. Activity; 

import android. app. AlertDialog; 

import android. content. Context; 

import android. content. DialogInterface; 

import android. content. DialogInterface. OnCancelListener; 
import android. graphics. Color; 

import android. os. AsyncTask; 

import android. os. Bundle; 

import android. util. Log; 

import android. view. View; 

import android. widget. LinearLayout; 

import android. widget. LinearLayout. LayoutParams; 

import android. widget. Toast; 

import cn. edu. hstc. httpclientdemo. util. DialogUtil; 
import cn. edu. hstc. httpclientdemo. util. HttpUtil; 

import cn. edu. hstc. httpclientdemo. util. MyListViewAdapter; 
import cn. edu. hstc. httpclientdemo. util. RefreshListView; 
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public class MainActivity extends Activity { 
private LinearLayout content; 
private CustomListView listview; 
private AlertDialog prompt; 
private MyListViewAdapter myListViewAdapter; 
private AsyncTask < String, Integer, String> access; 
private List <JSONObject > list = new ArrayList < JSONObject >(); 
private int index = 1; 
private int count; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R. layout. activity main); 
content = (LinearLayout) findViewById(R. id. content) ; 
listview = new CustomListView(this); 
listview. setLayoutParams(new LayoutParams(LayoutParams.MATCH PARENT, LayoutParams. 
MATCH PARENT)); 
listview. setFadingEdgeLength(0); 
listview. setCacheColorHint(Color. TRANSPARENT); 
content. addView(listview); 
myListViewAdapter = new MyListViewAdapter(MainActivity.this, list); 
acquire(true); 


private void acquire(final boolean dialog) ( 
access = new AsyncTask < String, Integer, String»() { 
(2 Override 
protected void onPreExecute() { 
super. onPreExecute() ; 
if (dialog) ( 
prompt = DialogUtil.prompt(MainActivity.this, "正在 加 载 中 ..."); 
prompt. setOnCancelListener(new OnCancelListener() { 
(GOverride 
public void onCancel(DialogInterface dialog) ( 
access. cancel(true); 


(Q Override 
protected String doInBackground(String... params) ( 
String result - null; 
try { 
// 如 果 不 是 加 载 更 多 , 则 获取 通讯 录 总 数 
if (!listview. pullLoading()) ( 
// 这 里 获取 通讯 录 总 数 用 的 是 Get 请 求 方式 
JSONObject object = new JSONObject(HttpUtil.getDataByGet 
(HttpUtil.BASE URL + "GetAddressBookCount")); 
if (object. has("count")) ( 
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count = object.optInt("count"); 
Log.i("", "count: " * count); 
} else ( 
result = object. optString("error"); // 结 果 为 错误 信息 


} 
if (count > 0) ( 
listview. setTotal(count); 
// 下 面 三 行 代码 用 的 是 Post 请 求 方式 
List < NameValuePair > paramList = new ArrayList < NameValuePair»(); 
paramList.add(new BasicNameValuePair("index", String. valueOf 
(index))); 
result = HttpUtil.getDataByPost(HttpUtil. BASE URL + 
"GetAddressBooks", paramList); 
// 也 可 以 注释 掉 上 面 三 行 代码 ,打开 下 面 这 一 行 代码 ,使 用 Get 请 求 方式 
// 获 取 数 据 
/*result = HttpUtil.getDataByGet(HttpUtil. BASE URL + 
"GetAddressBooks?index- " + index); */ 
) 
) catch (Exception e) ( 
e. printStackTrace(); 
) 


return result; 


(QOverride 
protected void onPostExecute(String result) { 
try ( 
if (result != null) ( 
JSONObject object = new JSONObject(result); 
if (object. has("data")) ( 
JSONArray array = object.optJSONArray("data"); 
if (array != null) ( 
if (array.length() > 0) ( 
if (listview. pullRefreshing() || dialog) 
list.clear(); 


for (inti = 0; i«array.length(); i++) ( 
list.add(array. optJSONObject(i)); 


content. setVisibility(View. VISIBLE); 


if (listview. pullRefreshing() || dialog) { 
listview. setAdapter(myListViewAdapter); 

} eise ( 
myListViewAdapter. notifyDataSetChanged(); 
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} 
} else if (object. has("error")) { 
Toast. makeText (MainActivity. this, object. optString("error"), 
Toast. LENGTH_LONG). show( ) ; 
} 
} else { 
list.clear(); 
myListViewAdapter. notifyDataSetChanged(); 
content. setVisibility(View.GONE); 
Toast. makeText (MainActivity. this, "暂时 没有 数据 !"，Toast. LENGTH - 
LONG). show() ; 


if (listview. pullRefreshing()) { 
listview. stopRefresh(); 
SimpleDateFormat sdf = new SimpleDateFormat("MM - dd HH:mn"); 
listview. setRefreshTime(sdf. format(new Date())) ; 

} else ( 
listview. stopLoadMore( ) ; 

} 

catch (Exception e) { 
e. printStackTrace(); 


if (dialog) ( 
prompt.dismiss(); 

else if (listview. pullRefreshing()) ( 
listview. stopRefresh(); 
SimpleDateFormat sdf = new SimpleDateFormat("MM - dd HH:mm"); 
listview. setRefreshTime(sdf. format (new Date())); 





else { 
listview. stopLoadMore() ; 


h 


access. execute() ; 


private class CustomListView extends RefreshListView implements RefreshListView. 


ListViewListener { 
public CustomListView(Context context) { 
super(context); 
setListViewListener(this); 


@Override 
public void onLoadMore() { 
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IT 
stopRefresh(); 
access. cancel(true); 
index; 
acquire(false); 

} 


@Override 

public void onRefresh() { 
stopLoadMore( ) ; 
access. cancel(true); 
index = 1; 
acquire(false); 


) 

m codes\10\10. 2\HttpClientDemo\cn\edu\hstc\httpclientdemo\activity\MainActivity. java 

服务 端 程序 并 不 是 本 书 所 学 习 重 点 ,如 果 读 首 GN sam 
有 兴趣 阅读 本 应 用 所 访问 的 后 台 程 序 代码 ,可 以 在 
本 书 所 附带 源码 中 获得 。 启 动 后 台 , 将 该 应 用 部 署 
在 Android 模拟 器 上 ,运行 效果 如 图 10. 6 一 图 10. 10 
所 示 。 

从 上 面 的 HttpUtil 工具 类 以 及 MainActivity 
类 中 可 以 得 知 ,使 用 HttpClient 发 送 请 求 、 接 收 响 
应 数据 其 实 很 简单 ,只 需要 如 下 几 个 步骤 即 可 : 

(D 创建 HttpClient 对 象 。 

© 如 果 需 要 发 送 Get 请 求 , 则 创建 HttpGet 
对 象 ; 如 果 需 要 发 送 Post 请 求 , 则 创建 HttpPost 
对 象 。 

O 如 果 需 要 发 送 请 求 参数 ,针对 Get 请 求 ,可 
以 直接 将 参数 拼接 在 请 求 地址 中 ; 针对 Post 请 
求 ,可 将 参数 封装 在 一 个 List < NameValuePair > 
params 中 ,然后 作为 HttpEntity 构造 器 参数 创建 
一 个 HttpEntity 对 象 ,再 调用 HttpPost 对 象 的 
setEntity ( HttpEntity entity) 方 法 将 创建 的 
HttpEntity 对 象 传人 , 即 可 传人 请 求 参 数 ; 实际 图 10.6 加载 数据 中 
上 ,也 可 以 调用 HttpGet、HttpPost 共同 的 
setParams( HttpParams params) 方 法 来 添加 请 求 参数 。 

CD 调用 HttpClient 对 象 的 execute(HttpUriRequest request) 发 送 请 求 ,执行 该 方法 返 
回 一 个 HttpResponse 对 象 。 

© 调用 HttpResponse 对 象 的 getEntity 方法 可 获取 HttpEntity 对 象 ,该 对 象 封装 了 
服务 器 的 响应 内 容 ,可 通过 EntityUtils. toString(HttpEntity entity) 方 法 将 响应 内 容 转 换 
为 字符 串 形 式 。 
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图 10.9 下 拉 松 手 开始 加 载 图 10.10 上 拉 加 载 更 多 数据 


(s Android 应 用 开发 从 入 门 到 精通 


(10,3 使 用 WebView 视图 开发 WebKit 应 用 


Android 浏览 器 的 内 核 是 WebKit 引擎 , WebKit 的 前 身 是 KDE 小 组 的 KHTML, 
Apple 将 KHTML 发 扬 光 大 ,推出 了 KHTML 的 改进 型 的 WebKit 引擎 的 浏览 器 Safari, 获 
得 了 非常 好 的 反响 。WebKit 内 核 在 手机 上 的 应 用 十 分 广泛 ,例如 Google 的 手机 Gphone、 
Apple 的 iPhone 等 所 使 用 的 Browser 内 核 引 擎 ,都 是 基于 WebKit。 随 着 计算 机 、 手 机 及 联 
网 装置 的 普及 ,未 来 终端 运算 都 会 在 云端 执行 ,目前 云 计算 技术 在 网 络 服务 中 已 经 随处 可 
见 , 例 如 搜索 引擎 、 网 络 信箱 等 ,使 用 者 只 要 输入 简单 指令 即 可 得 到 大 量 信息 。 未 来 的 手机 、 
GPS 等 行动 装置 都 可 以 通过 云 计 算 技 术 ,发 展 出 更 多 的 应 用 服务 。 因 此 人 们 只 要 拥有 一 个 
功能 强大 的 浏览 器 ,就 能 满足 平时 工作 生活 的 需要 。 本 节 将 通过 Android 中 的 WebKit 包 


10.3.1 WebKit 概述 


WebKit 是 一 个 开源 浏览 器 网 页 排版 引擎 ,与 之 响应 的 引擎 有 Gecko(CMozila、Firefox 
等 使 用 的 排版 引擎 ) 和 Trident( 也 称 MSHTML, 是 IE 使 用 的 排版 引擎 ) 。 同 时 , WebKit 也 
是 苹果 Mac OS-X 系统 引擎 框架 版 本 的 名 称 ,主要 用 于 Safari, Dashboard, Mail 和 其 他 一 些 
Mac OS-X 程序 。WebKit 所 包含 的 WebCore 排版 引擎 和 JSCore 引擎 来 自 于 KDE 的 
KHTML 和 KJS, 当 年 苹果 比较 了 Gecko 和 KHTML 后 ,仍然 选择 了 后 者 ,就 因为 它 拥有 
清晰 的 源码 结构 , 极 快 的 泻 染 速度 。 而 今 Android 系统 也 毫 不 犹 殉 地 选择 了 WebKit, CA 
有 各 触摸 屏 、 高 级 图 形 显示 和 上 网 功能 ,用 户 能 够 在 手机 上 查看 电子 邮件 ,搜索 网 址 和 观看 
视频 节目 等 。 可 以 看 出 这 是 一 个 非常 强大 的 Web 应 用 平台 。 

WebKit 由 三 个 模块 组 成 : JavaScriptCore, WebCore 和 WebKit. 

(D WebKit: 整个 项 目的 名 称 。 

Q) JavaScriptCore: JS 虚拟 机 ,相对 独立 ,主要 用 于 操作 DOM. DOM 是 W3C 定义 的 
规范 ,主要 用 于 定义 外 部 可 以 操作 的 浏览 器 内 核 的 接口 ,而 WebCore 必须 实现 DOM 规范 。 

(3) WebCore: 整个 项 目的 核心 ,用 来 实现 Render 引擎 ,解析 Web 页 面 , 生 成 一 个 DOM 
树 和 一 个 Render 树 。 

JavaScriptCore 的 主要 功能 有 : 

(D API 一 一 基本 JavaScript 功能 。 

© Binding 一 一 与 其 他 功能 绑 定 的 功能 ,如 DOM、C、JNI1。 

(3) DerviedSource 一 一 自动 产生 的 代码 。 

@ PCRE—— Perl-Compatible Regular Expressions(Perd 兼容 的 规则 表达 式 ) 。 

(9 KJS—— Javascript Kernel(JavaScript 内 核 ) 。 

WebCore 的 主要 功能 有 : 

(D Loader 一 一 加 载 资源 及 Cache 实现 (Curl) 。 

© DOM —HTML 词法 分 析 与 请 法 分 析 。 

( DOM —- DOM 节点 与 Render 节点 创建 ,形成 DOM 树 。 
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(D Render—— Render 树 介绍 ,RenderBox。 

© Layout 一 一 排版 介绍 。 

(& Css Parser 模块 。 

@ Binding—— DOM 5j JavascriptCore 绑 定 的 功能 。 

对 WebKit 各 个 模块 的 功能 有 了 了 解 ,下 面 看 看 WebKit 的 解析 过 程 是 怎样 的 。 流 程 
WTF: 

(D CURL 获得 网 站 的 Stream, 

@ 解析 划分 字符 串 。 

© 通过 DOM Builder 按 合法 的 HTML 规范 生成 DOM 树 。 

© 如 果 有 JavaScript. JSEngine 就 通过 ECMA-262 标准 完善 DOM 树 。 

(& 把 DOM 传 给 LayoutEngine 进行 布局 ,如 果 有 CSS 样式 ,就 通过 CSSParser 解析 。 

© 最 后 演 染 Rendering 出 来 。 

而 Google 对 WebKit 进行 了 封装 ,为 开发 者 提供 了 丰富 的 Java 接口 ,其 中 最 重要 的 便 
是 android. webkit. WebView 控件 。 下 面 重点 学 习 WebView 组 件 的 使 用 。 


10.3.2 使 用 WebView 浏览 网 页 


Android 提供 了 WebView 组 件 专 门 来 浏览 网 页 ,和 其 他 控件 一 样 , 它 使 用 起 来 非常 
简单 。 

WebView 组 件 本 身 就 是 一 个 浏览 器 实现 , 它 的 内 核 基于 10.3. 1 节 介 绍 的 开源 WebKit 
引擎 。 如 果 对 WebView 进行 一 些 美化 .包装 .可 以 非常 轻松 地 开发 出 自己 的 浏览 器 。 下 面 
通过 一 个 实例 介绍 Android 如 何 使 用 WebView 控件 来 浏览 网 页 。 

该 实例 需求 比较 简单 ,在 页 面 中 放置 一 个 EditText 控件 供用 户 输入 要 访问 的 网 址 ,在 
输入 框 的 右边 放置 一 个 Button( 按 钮 ) ,在 这 两 个 控件 的 下 方 放 置 一 个 WebView 组 件 , 当 用 
户 输入 网 址 后 单 击 按钮 , 则 Web View 加 载 该 网 址 内 容 , 当 单 击 网 页 中 任意 链接 ,需要 在 当 
前 的 WebView 中 打开 , 当 用 户 按 下 硬 键盘 中 的 返回 键 , 即 当 后 退 时 ,在 当前 WebView 中 加 
载 上 一 个 网 页 。 应 用 界面 布局 如 下 : 


< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "match parent" 
android:layout height = "match parent" 
android:orientation = "vertical" > 


< RelativeLayout 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
android:hint = "请 输入 您 的 网 址 .…" > 


< Button 
android:id= "@ + id/btn go" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout alignParentRight - "true" 
android:text = "GO" /> 
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« EditText 

android:id- "(2 + id/edt url" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout toLeftOf = "(did/btn go" 
android:text = "http://www. baidu. com" 
android: hint = "请 输入 您 的 网 址 …”/> 

</RelativeLayout > 





:id= "(à + id/webView" 
android:layout width- "fill parent" 
android:layout height - "fill parent" /» 


«/LinearLayout > 
代码 文件 : codes\10\10. 3NWebViewDemoVresMlayoutVactivity main. xml 


上 面 布局 所 对 应 的 Activity 代码 如 下 : 


package cn. edu. hstc. webviewdemo. activity; 


import android. app. Activity; 

import android. graphics. Bitmap; 
import android. os. Bundle; 

import android. view. KeyEvent; 

import android. view. View; 

import android. webkit. WebSettings; 
import android. webkit. WebView; 
import android. webkit.WebViewClient; 
import android. widget. Button; 

import android. widget. EditText; 


public class MainActivity extends Activity ( 
private EditText urlEdt; 
private Button goBtn; 
private WebView webView; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
initView(); 


private void initView() { 
urlEdt = (EditText) findViewById(R. id.edt url); 
goBtn = (Button) findViewById(R. id. btn go); 
webView = (WebView) findViewById(R. id. webView); 


goBtn. setOnClickListener(new View.OnClickListener() { 
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GOverride 
public void onClick(View v) ( 


webView. loadUrl(urlEdt.getText().toString()); 
) 
n; 


WebSettings webSettings = webView.getSettings(); 
// 设 置 支持 JavaScript 脚本 

webSettings. setJavaScriptEnabled(true); 

// 设 置 可 以 访问 文件 

webSettings. setAllowFileAccess(true); 


// 设 置 支持 缩放 
webSettings. setBuiltInZoomControls(true); 


webView. setWebViewClient (new WebViewClient() { 


@Override 
public boolean shouldOverrideUrlLoading(WebView view, String url) { 


webView.loadUrl(url);  — // 当 有 新 的 链接 时 ,使 用 当前 的 WebView 来 显示 
return true; 
) 


(QOverride 

public void onPageFinished(WebView view, String url) ( 
super. onPageFinished(view, url); 

) 


(2 0Override 
public void onPageStarted(WebView view, String url, Bitmap favicon) ( 
super.onPageStarted(view, url, favicon); 
) 
H; 
} 


@Override 
public boolean onKeyDown( int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent. KEYCODE BACK && webView.canGoBack()) { 
webView. goBack() ; // 后 退 
return true; 


) 
return super.onKeyDown(keyCode, event); 


} 
代码 文件 : codes V 10V 10. 3 V WebViewDemo V cn V edu V hstc V webviewdemo V activity V 


MainActivity. java 
最 后 ,不 要 忘 了 在 AndroidManifest. xml 中 为 该 应 用 添加 访问 网 络 的 权限 : 
< uses - permission android:name = "android. permission. INTERNET" /> 


将 上 面 的 应 用 部 署 在 Android 模拟 器 中 ,输入 百度 首页 地 址 , 单 击 GO 按钮 ,可 以 看 到 
如 图 10. 11 所 示 效 果 图 。 
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单 击 图 10. 11 中 的 “文库 ”链接 ,将 可 以 看 到 如 图 10. 12 所 示 效 果 。 
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图 10.11 WebView 显示 百度 首页 图 10.12 在 当前 WebView 中 加 载 链接 


应 用 地 图 贴吧 ”hao123 $£ 


完整 版 


当 用 户 按 下 硬 键盘 上 的 返回 键 时 ,将 回 到 百度 首页 页 面 ,如 图 10. 11 所 示 。 

阅读 MainActivity 类 的 源码 ,可 以 发 现 ,程序 调用 WebView 的 loadUrlCString url) 方 
法 加 载 、 显 示 界 面 EditText 输入 框 中 所 指定 URL 的 网 页 ,该 行 代码 亦 是 程序 的 关键 代码 。 
实际 上 ,WebView 提供 了 大 量 的 方法 来 执行 浏览 器 操作 ,如 表 10.4 所 示 。 


表 10.4 WebView 提供 的 常用 方法 





方法 名 描 述 
void goBack 后 退 
void goForward 前 进 
void loadUrl(String url) 加 载 指 定 URL 对 应 的 网 页 
booleanzoomIn 放大 网 页 
boolean zoomOut 缩小 网 页 


继续 分 析 代 码 可 以 发 现 ,程序 创建 了 一 个 WebSettings 对 象 .并 通过 该 对 象 设置 了 
WebView 的 一 些 属性 ,状态 等 。 在 创建 WebView 时 ,系统 有 一 个 默认 的 设置 ,可 以 通过 
WebView. getSettings 来 得 到 这 个 设置 。 

WebSettings 和 WebView 在 同一 个 生命 周期 中 存在 , 当 WebView 被 销毁 后 ,如 果 再 使 
用 WebSettings, 则 会 抛 出 IIIegalStateException 异常 。 实 际 上 ,除了 代码 中 WebSettings 
的 设置 外 ,还 提供 了 如 表 10. 5 所 示 的 一 些 常用 的 属性 ,状态 的 设置 方法 。 
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510.5 ”WebSettings 提供 的 常用 方法 





方 法 名 描 述 
setAllowFileAccess 启动 或 禁止 WebView 访问 文件 数据 
setBlockNetWorkImage 是 否 显示 网 络 图 像 
setCacheMode 设置 缓冲 模式 
setDefaultFontSize 设置 默认 的 字体 大 小 
setDefaultTextEncodingName 设置 在 解码 时 使 用 的 默认 编码 
setFixedFontFamily 设置 固定 使 用 的 字体 


WebSettings 所 提供 的 方法 太 多 了 ,这 里 只 是 展示 部 分 常用 方法 ,读者 可 以 通过 官方 


API 获得 更 多 的 方法 。 


代码 中 调用 了 WebView 对 象 的 setWebViewClient 方法 为 WebView 指定 了 一 个 
WebViewClient 对 象 , 并 且 重 写 了 WebViewClient 中 的 shouldOverrideUrlLoading 方法 ， 
正 是 该 方法 中 的 代码 行 webView. loadUrl(url) 控 制 了 当 单 击 WebView 中 显示 网 页 的 内 嵌 
链接 时 ,继续 在 当前 WebView 中 加 载 。 如 若 不 为 WebView 指定 WebViewClient 对 象 并 重 
写 该 方法 , 则 默认 会 在 系统 自 带 浏览 器 中 打开 新 链接 。WebViewClient 就 是 专门 辅助 
WebView 处 理 各 种 通知 ,请求 事件 的 类 。 表 10. 6 展示 了 部 分 WebViewClient 所 提供 的 方 
法 ,可 以 通过 覆盖 这 些 方法 来 辅助 WebView 浏览 网 页 。 


表 10.6  WebViewClient 提供 的 常用 方法 





方 法 名 di x 
doUpdateVisitedHistory 更 新 历史 记录 
onFormResubmission 应 用 程序 重新 请 求 网 页 数据 
onLoadResource 加 载 指定 网 址 提供 的 资源 
onPageFinished 网 页 加 载 完 毕 
onPageStarted 网 页 开始 加 载 
onReceivedError 报告 错误 信息 
onScaleChanged WebView 发 生 改变 
shouldOverrideUrlLoading 控制 新 的 链接 在 当前 WebView 中 打开 


以 上 便 是 WebView 组 件 开发 的 简单 介绍 ,读者 车 有 兴趣 ,可 以 深入 了 解 WebView JF 
发 的 更 多 知识 ,然后 完善 本 实例 所 开发 的 浏览 器 应 用 ,其 至 完全 可 以 开发 出 一 个 系统 自 带 浏 


览 器 的 替代 产品 。 


10.3.3 使 用 WebView 加 载 HTML 代码 


在 10.2.1 节 所 开发 的 实例 中 ,采用 了 一 个 TextView 来 显示 从 网 络 上 获取 到 的 
HTML 字符 串 ,如 图 10. 3 所 示 ,可 以 看 到 ,TextView 并 不 会 对 HTML 标签 进行 解析 ,而 是 
把 整 串 标准 HTML 代码 字符 串 直接 显示 出 来 ,当然 这 对 EditText 来 说 ,也 是 一 样 的 效果 。 
那么 ,Android 中 是 否 有 组 件 可 以 对 HTML 字符 串 进行 解析 ,然后 显示 HTML 中 所 包含 的 
页 面 内 容 呢 ? 答案 是 肯定 的 。10. 3. 2 节 介 绍 的 WebView 组 件 便 能 实现 上 述 功能 。 

WebView 提供 了 一 个 loadData(String data. String mimeType，String encoding) 方 法 
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来 加 载 并 显示 指定 的 HTML 代码 ,该 方法 的 三 个 参数 含义 如 下 : 
指定 要 加 载 HTML 代码 。 
指定 所 加 载 的 HTML 代码 的 MIME 类 型 ,对 于 HTML 代码 可 指定 





æ data 





a mimeType 
为 text/html, 
g encoding — 48 i£ HTML 代码 编码 所 用 的 字符 集 , 比 如 GBK 或 者 UTF-8。 
下 面 通 过 一 个 实例 来 展示 WebView 加 载 HTML 代码 ,在 应 用 布局 界面 上 放置 一 个 
WebView 组 件 , 用 于 显示 解析 HTML 字符 串 后 的 内 容 , 该 界面 布局 代码 非常 简单 , 故 不 在 
此 进行 展示 ,下 面 直接 粘贴 Java 程序 代码 部 分 。 


package cn. edu. hstc. webviewdemo. activity; 


import android. app. Activity; 
import android. os. Bundle; 
import android. webkit.WebView; 


public class MainActivity extends Activity { 
private WebView webView; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate( savedInstanceState); 
setContentView(R.layout.activity main); 
initView(); 


) 


private void initView() { 
webView = (WebView) findViewById(R. id. webView); 
// 访 问 后 台 ,获取 响应 的 HTML S 
String data = HttpUtil.getDataByGet(HttpUtil. BASE URL + "TransportationHtml"); 
System. out. println(data); 
/ f Fl 1oadData 方法 加 载 HTM1 代码 
webView.loadData(data, "text/html", "utf - 8"); 


) 


上 面 的 程序 实现 在 应 用 的 启动 界面 中 ,访问 后 台地 址 ,获取 返回 的 THML 字符 串 ,并 
通过 WebView 组 件 进行 解析 并 显示 。 上 面 所 指定 访问 的 后 台 与 10. 2. 2 节 的 实例 中 所 使 
用 的 后 台 为 同一 个 ,程序 中 所 用 到 的 HttpUtil 工具 也 是 10. 2. 2 节 的 实例 中 所 使 用 的 工具 
类 ,也 就 是 说 ,上 面 的 代码 中 利用 了 HttpClient Get 方式 请 求 了 后 台 并 获得 了 响应 内 容 ,只 
不 过 该 响应 内 容 是 一 串 HTML 代码 ,至 于 代码 中 所 访问 的 后 台地 址 如 何 实现 返回 这 一 串 
HTML 代码 并 不 是 我 们 关心 的 内 容 , 读 者 可 以 通过 本 书 附带 源码 获取 后 台 的 实现 源码 。 

启动 服务 端 ,并 将 上 面 的 应 用 部 署 于 Android 模拟 器 中 ,可 以 看 到 如 图 10. 13 所 示 
界面 。 

从 图 10.13 可 以 看 到 ,WebView 所 显示 的 内 容 出 现 了 乱码 ,难道 后 台所 返回 的 HTML 
代码 就 是 如 此 吗 ? 由 于 在 程序 中 有 对 后 台 的 响应 内 容 进行 输出 ,所 以 可 以 通过 LogCat 窗 
口 看 到 此 时 后 台所 返回 的 内 容 , 如 图 10. 14 所 示 。 
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10.13 WebView 显示 乱码 


Syszem.out <!DOCTYPE HTML PUBLIC 7-//W3C//DID HTML 4.01 Transitional//EN*» 
Syszem.out «me» 

Syszem.out <HEAD><TITLÐA Servletc/TITLE»«/BEAD» 

Syszem.out «BODY» 

Syszem.out 我 是 HTMLBODY 体 ， 我 将 被 可 数 到 RebView 中 </BODY> 

Syszem.out </HTML> 


10.14 后 台 响应 内 容 


从 图 10. 14 中 可 以 看 出 , WebView 中 所 显示 的 内 容 应 该 为 "我 是 HTMLBODY 体 ,我 
将 被 加 载 到 WebView 中 ? 才 对 ,可 是 ,启动 应 用 后 , WebView 组 件 中 所 显示 的 内 容 为 什么 
会 出 现 乱码 呢 ? 怎样 才能 避免 乱码 呢 ? 

实际 上 ,即使 为 上 面 代码 中 的 loadData 方法 指定 encoding 为 “gbk? 或 “gb2312”, 也 同 
样 无 法 解决 中 文 乱码 问题 。 但 是 程序 中 代码 行 webView. loadData (data, "text/html", 
"utf-8") 却 是 Android API 所 提供 的 标准 用 法 ,这 可 以 算 作 Android API 的 一 个 漏洞 吧 。 
幸好 , Android WebView 提供 了 loadDataWithBaseURL (String baseUrl. String data. 
String mimeType. String encoding. String historyUrl) 方 法 来 加 载 HTML 代码 。 使 用 该 
方法 ,将 可 以 避免 中 文 乱码 问题 。 

将 上 面 的 程序 代码 稍微 修改 一 下 .修改 后 的 代码 如 下 所 示 : 


package cn. edu. hstc. webviewdemo. activity; 


import android. app. Activity; 
import android. os. Bundle; 
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import android. webkit. WebView; 


public class MainActivity extends Activity { 
private WebView webView; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
initView(); 


) 


private void initView() { 
webView = (WebView) findViewById(R. id. webView); 
// 访 问 后 台 , 获 取 响 应 的 HTML 字符 串 
String data = HttpUtil.getDataByGet(HttpUtil. BASE URL + "TransportationHtml"); 
System. out. println(data); 


// 使 用 loadData 方法 加 载 HTM1 代码 ,如 果 解 析出 来 的 内 容 中 含有 中 文 ,将 会 造成 乱码 
webView.loadData(data, "text/html", "utf - 8"); 


// 使 用 1oadDataWithBaseURL 方法 加 载 HTML. 代码 ,避免 乱码 
webView.loadDataWithBaseURL(null, data, "text/html", "utf - 8", null); 


) 
代码 文件 : codes\10\10. 3VWebViewHTMLDemoVcnVeduVhstc WwebviewhtmldemoVact ivityN 
MainActivity. java 


将 应 用 再 次 部 署 于 Android 模拟 器 中 ,可 以 看 到 如 图 10. 15 所 示 的 运行 界面 。 
BM e 3:57rm 
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图 10.15 避免 中 文 乱码 
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通过 以 上 介绍 ,相信 读者 已 经 学 会 了 如 何 实用 WebView Jn z HTML 代码 了 。 
(10.4 本 章 小 结 


本 章 主要 介绍 了 Android 网 络 编程 的 相关 知识 ,通过 本 章 的 学 习 , 读 者 需要 掌握 如 何 开 
发 Android Socket 应 用 ,利用 HttpURLConnection 类 使 用 HTTP 方式 访问 网 络 ,由 于 
Android 还 支持 Apache HttpClient, 故 读 者 需要 掌握 使 用 HttpClient 接口 开发 ,使 用 
HttpClient 可 以 方便 地 与 服务 端 进行 交互 ,Android 端 可 以 方便 地 发 送 请 求 以 及 接收 响应 
内 容 。 此 外 , Android WebView 组 件 内 核 基于 WebKit 引擎 ,可 以 加 载 任意 网 页 和 解析 
HTML 格式 的 字符 串 ,读者 需要 学 会 使 用 WebView 视图 开发 WebKit 应 用 。 
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通过 前 面 10 个 章节 的 介绍 ,相信 读者 已 经 对 开发 Android 应 用 的 流程 有 了 一 定 的 认 
知 ,并且 已 经 掌握 了 Android 的 基础 知识 ,掌握 了 Android 四 大 组 件 的 开发 ,已 经 有 能 力 独 
立 开 发 一 个 属于 自己 的 Android 应 用 了 。 在 本 章 将 开发 一 个 完整 的 Android 应 用 ,该 应 用 
将 涉及 一 些 在 当今 应 用 市 场 中 比较 热门 的 技术 。 


(1. 1 OR where 功能 需 > 
P 


本 章 要 实现 的 Android 应 用 ,名 叫 QR where, 通 过 该 名 字 , 也 许 无 从 知道 该 应 用 是 做 什 
么 的 。 事实 上 ,当今 社会 ,到 处 充斥 着 各 种 二 维 码 ,扫描 二 维 码 可 以 进行 电子 支付 ,可 以 识别 
微 信 公 众 号 或 者 普通 的 微 信 账 号 ,可 以 跳 转 到 链接 等 等 。 而 二 维 码 的 英文 名 字 也 叫 QR 
Code, QR where 正 是 一 款 对 二 维 码 进行 解析 、 对 四 种 特定 类 型 的 信息 生成 二 维 码 的 应 用 。 
在 这 四 种 特定 类 型 中 ,其 中 一 种 是 地 理 位 置信 息 ,于 是 ,选取 单词 QR Code 里 面 的 QR ,再 加 
上 单词 where, 就 构成 了 应 用 名 称 QR where. 

QR where 提供 一 个 扫描 框 供用 户 扫描 二 维 码 , 应 用 解析 二 维 码 , 读 取 二 维 码 信 息 , 然 
后 跳 转 到 相应 的 类 型 的 详情 页 面 中 。QR where we 
种 类 型 分 别 是 长 链接 (网 址 ) 、 手 机 联系 人 、 地 理 信息 (经 纬度 ) 、WiFi 信息 。 这 四 个 类 型 的 详 

情 页 面 对 应 着 不 同 的 操作 界面 并 提供 不 同 的 功能 。 
对 于 保存 了 网 址 文本 的 二 维 码 ,应 用 扫描 该 二 维 码 解析 后 跳 转 到 的 页 面 显示 了 解析 后 
的 网 址 文本 信息 ,并 在 该 文本 下 方 生 成 了 一 张 对 应 的 二 维 码 图 片 , 相 当 于 将 扫描 到 的 二 维 码 
显示 在 手机 应 用 中 。 在 页 面 底部 从 上 而 下 提供 了 两 个 按钮 : 一 个 供用 户 单 击 后 在 手机 自 带 
浏览 器 中 打开 该 网 址 链接 ; 一 个 供用 户 单 击 后 将 该 串 链接 复制 到 手机 粘贴 板 中 ,以 便 用 户 
进行 粘贴 文本 操作 。 

对 于 保存 了 手机 联系 人 信息 的 二 维 码 ,应 用 扫描 该 二 维 码 解析 后 跳 转 到 的 页 面 显 示 了 
该 联系 人 的 相关 信息 ,比如 姓名 电话、 邮箱 等 。 在 电话 文本 的 右边 提供 发 送 短 消息 .拨打 电 
话 的 按钮 供用 户 分 别 操作 这 两 项 功能 。 在 页 面 中 也 提供 以 现 有 的 联系 人 信息 创建 新 联系 人 
以 及 将 页 面 中 的 联系 人 信息 添加 到 手机 现 有 联系 人 中 的 功能 。 i oo 
钮 供用 户 单 击 跳 转 到 另外 一 张 页 面 显示 生成 的 联系 人 信息 对 应 的 二 维 码 。 

对 于 保存 了 经 纬度 文本 信息 的 二 维 码 ,应 用 扫描 该 二 we 采用 高 
德 地 图 ,定位 到 该 二 维 码 中 的 经 纬度 的 地 点 ,并 在 地 图 中 画 上 标记 ,在 地 图 的 下 方 显示 提供 
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三 个 文本 显示 组 件 分 别 显示 经 度 、 纬 度 、 街 道 地 址 。 在 页 面 底部 提供 两 个 按钮 供用 户 单 击 根 
据 该 经 纬度 信息 生成 二 维 码 图 片 以 及 通过 手机 自 带 浏览 器 打开 地 图 定位 到 该 经 纬度 。 

对 于 保存 了 WiFi 信息 的 二 维 码 ,应 用 扫描 该 二 维 码 解 析 后 跳 转 到 的 页 面 显 示 了 该 Wi- 
Fi 信息 的 SSID、Password、Network Type 三 个 属性 ,其 实 就 是 直接 将 二 维 码 中 文本 信息 拆 
分 出 来 ,显示 在 页 面 上 。 在 文本 信息 的 下 方 还 提供 了 一 张 根据 WiFi 信息 所 生成 的 二 维 码 
图 片 ,相当 于 将 扫描 到 的 二 维 码 显示 在 手机 中 。 在 二 维 码 图 片 的 下 方 提供 了 一 个 按钮 供用 
户 单 击 复制 该 串 Wi-Fi 文本 信息 。 

如 解析 出 来 的 文本 并 非 这 四 种 类 型 的 信息 , 则 跳 转 到 一 个 显示 了 包含 该 文本 信息 的 二 
维 码 图 片 的 页 面 。 

在 以 上 所 介绍 的 四 种 类 型 以 及 其 他 非 这 四 种 类 型 的 信息 的 详情 页 面 中 ,只 要 有 包含 二 
维 码 图 片 的 页 面 ,在 页 面 的 右上 角 都 会 提供 一 个 按钮 , 单 击 该 按钮 , 便 会 在 页 面 底 部 弹出 三 
个 按钮 : 第 一 个 按钮 供用 户 单 击 跳 转 到 发 送 Email 的 应 用 ,并 携带 该 二 维 码 图 片 , 作 为 
Email 的 邮件 内 容 ,用户 可 以 将 该 二 维 码 图 片 通过 邮件 发 送 到 其 他 邮箱 中 ; 第 二 个 按钮 供用 
户 单 击 后 将 该 二 维 码 图 片 保存 到 手机 的 系统 相册 中 ; 第 三 个 按钮 则 是 取消 底部 弹出 菜单 的 
功能 。 

以 上 所 介绍 的 是 对 保存 了 各 种 不 同 信息 的 二 维 码 进行 解析 后 所 做 的 不 同 的 跳 转 处 理 。 
事实 上 ,我 们 需要 从 应 用 的 全 局 上 进行 需求 分 析 。QR where 底部 有 四 大 菜单 , 接 下 来 分 别 
介绍 这 四 个 菜单 中 所 包含 的 具体 功能 需求 。 

(D Scan: 第 一 个 底部 菜单 称 为 Scan。 大 家 都 知道 ,扫描 的 英文 单词 是 scanning, MF 
面 上 理解 ,该 部 分 的 功能 是 为 提供 二 维 码 扫描 操作 。 

如 单 击 底 部 第 一 个 菜单 按钮 ,将 会 在 页 面 中 提供 一 个 二 维 码 扫 描 框 ,用 户 将 该 扫描 框 对 

准 任意 二 维 码 , 应 用 将 会 对 该 二 维 码 进行 解析 后 跳 转 到 上 面 所 介绍 的 四 种 类 型 的 详 
情 页 面 之 一 或 者 弹出 一 个 对 话 框 显示 解析 出 来 的 文本 信息 。 

如 在 页 面 的 左上 角 则 提供 了 一 个 相册 按钮 , 单 击 该 按钮 , 则 进入 系统 相册 ,选中 任意 一 
张 图 片 ,会 返回 应 用 页 面 中 ,应 用 对 选中 的 图 片 进行 解析 ,如 果 该 图 片 不 是 二 维 码 图 
片 , 则 提示 用 户 ; 如 果 该 图 片 是 二 维 码 图 片 . 则 将 二 维 码 进行 解析 后 , 跳 转 到 详情 页 
面 。 这 与 通过 扫描 框 解析 二 维 码 类 似 。 

艺 无 论 通过 扫描 框 还 是 通过 浏览 系统 相册 的 方式 ,只 要 是 将 二 维 码 图 片 成 功 解析 出 来 
后 , 则 会 将 该 二 维 码 的 文本 信息 保存 在 Android 自 带 的 SQLite 数据 库 中 。 

女 在 页 面 的 右上 角 提 供 了 一 个 按钮 供用 户 打 开 或 关闭 手机 自 带 的 闪光 灯 功 能 。 

© History: 第 二 个 底部 菜单 称 为 History, History 是 历史 的 英文 单词 ,很 容易 理解 ， 
这 部 分 用 于 查询 应 用 的 SQLite 数据 库 中 的 数据 并 以 列表 的 形式 显示 在 页 面 中 。 

History 记录 分 为 两 种 类 型 : 一 种 是 通过 底部 第 一 个 菜单 中 扫描 或 浏览 系统 相册 并 

解析 二 维 码 后 所 保存 的 二 维 码 文本 信息 ,另外 一 种 类 型 则 是 通过 接 下 来 所 要 介绍 的 
第 三 个 菜单 中 的 生成 二 维 码 功能 后 所 保存 的 二 维 码 文本 信息 。 因 此 ,在 该 页 面 中 ,以 
Tab 标签 页 形式 分 别 显示 了 Scan 类 型 的 历史 记录 列表 和 Generate 类 型 的 历史 记录 
列表 。 

名 单 击 任意 一 项 列表 项 , 则 会 跳 转 到 该 条 历史 记录 所 对 应 的 详情 页 面 ,该 部 分 的 页 面 跳 

转 与 扫描 二 维 码 信息 后 的 页 面 跳 转 完全 一 致 。 
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© Generator; 第 三 个 底部 菜单 称 为 Generator, 即 为 生成 器 , 它 提供 了 根据 以 上 所 介绍 
的 四 种 类 型 的 信息 生成 对 应 的 二 维 码 的 功能 。 因 此 在 该 部 分 的 页 面 上 从 上 至 下 放置 了 四 个 
大 的 按钮 供用 户 单 击 跳 转 到 不 同类 型 的 信息 编辑 页 面 中 。 
z QR/Short URL; 单 击 页 面 中 的 QR / Short URL 按钮 , 跳 转 到 网 址 编辑 页 面 ,在 页 
面 的 网 址 输入 框 中 输入 网 址 ,该 输入 框 提供 了 对 网 址 的 格式 验证 功能 。 输 入 网 址 信 
息 后 , 单 击 页 面 项 部 的 生成 按钮 , 则 跳 转 到 二 维 码 生成 页 面 ,在 页 面 中 显示 了 所 生成 
的 二 维 码 , 并 且 同 样 在 页 面 右上 角 提 供 按钮 供用 户 单 击 显 示 更 多 的 底部 按钮 ,以 供用 
户 操作 发 送 邮 件 .保存 二 维 码 图 片 到 系统 相册 。 
g Contact; 单 击 页 面 中 的 Contact 按钮 , 跳 转 到 手机 联系 人 信息 编辑 页 面 ,在 该 页 面 中 
提供 了 各 种 手机 联系 人 的 基础 信息 的 输入 框 。 也 可 单 击 页 面 右上 角 所 提供 的 按钮 ， 
应 用 将 会 调用 系统 所 自 带 的 手机 联系 人 应 用 ,选中 任意 一 个 联系 人 , 则 返回 本 应 用 并 
将 选中 的 联系 人 信息 自动 打印 在 页 面 中 的 各 个 对 应 的 编辑 框 中 。 然 后 ,用 户 即 可 单 
击 页 面 中 的 生成 按钮 ,同样 会 生成 一 张 带 有 联系 人 信息 的 二 维 码 图 片 。 
g Location; 单 击 页 面 中 的 Location 按钮 , 跳 转 到 地 理 位 置 定位 页 面 ,在 该 页 面 中 集成 
了 高 德 地 图 ,在 地 图 展示 的 下 方 放 置 了 一 个 检索 框 供用 户 输入 地 点 ,然后 精确 搜索 出 
该 地 理 名 称 的 经 纬度 。 该 检索 框 带 有 自动 完成 的 功能 ,比如 输入 潮州 两 字 ,将 会 自动 
出 现 潮州 宾馆 ,潮州 市 人 民政 府 、 潮 州 西湖 等 地 点 供用 户 选择 。 在 搜索 出 来 的 地 理 位 
置 会 添加 上 地 图 标注 , 单 击 该 标注 ,会 弹出 街道 信息 ,这 些 都 是 高 德 地 图 开发 的 内 容 ， 
在 应 用 开发 过 程 中 也 将 会 涉及 。 单 击 页 面 中 的 生成 按钮 ,生成 一 张 包含 所 搜索 地 理 
位 置 的 经 纬度 信息 的 二 维 码 图 片 。 
ze WiFi, 单 击 页 面 中 的 WiFi 按钮 , 跳 转 到 WiFi 信息 编辑 页 面 ,在 该 页 面 中 提供 了 
SSID、Password 两 个 文本 输入 框 , 提 供 一 个 Network Type 选择 器 ,该 选择 器 其 实 就 
是 一 个 文本 显示 组 件 , 单 击 该 文本 控件 ,将 会 在 页 面 底部 弹出 四 个 Button 按钮 , 单 击 
前 面 三 个 按钮 可 以 选择 WEP、WPA/WPA2 两 中 WiFi 加 密 方式 ,或 者 选择 
Noencryption 表示 该 WiFi 没有 任何 加 密 方式 ,最 后 一 个 Button 按钮 为 取消 底部 菜 
单 的 功能 。 单 击 页 面 中 的 生成 按钮 ,将 会 跳 转 到 另 一 个 页 面 显 示 包 含 了 WiFi 信息 
的 二 维 码 图 片 。 
@ Setting: 第 四 个 底部 菜单 成 为 Setting, 即 设置 。 该 部 分 主要 提供 两 个 功能 : 一 个 是 
Clear History( 清 空 数据 库 ) , 另 一 个 是 About( 关 于 ) 。 
以 上 便 是 QR where 的 全 部 功能 需求 的 介绍 。 接 下 来 ,将 会 根据 QR where 底部 的 四 
个 菜单 项 ,分 别 介绍 开发 过 程 。 


(2 开发 启动 界面 MainActivity 


11.1 节 已 经 介绍 了 QR where 的 功能 需求 ,已 经 了 解 了 QR where 底部 有 四 个 大 的 菜 
单 模块 。 根 据 现 有 的 Android 知识 体系 .可 以 使 用 Android Fragment 来 实现 底部 菜单 。 

首先 ,需要 为 底部 菜单 定义 布局 文件 ,在 该 文件 中 实现 了 底部 菜单 的 布局 , QR where 
底部 菜单 中 的 每 个 菜单 按钮 为 一 个 图 标 ,因此 ,只 需要 在 该 布局 文件 中 放置 一 个 ImageView 
组 件 , 布 局 代码 如 下 所 示 : 
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<?xml version= "1.0" encoding = "utf - 8"?> 
< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:gravity = "center" 
android:orientation = "vertical" > 


« ImageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:focusable - "false" 
android:padding - "3dp" 
android: src = "(Qdrawable/scan tab btn" 
android: id = "(9 + id/imageview" /» 


«/LinearLayout > 
代码 文件 : codes\11\11.2\QR whereVresMlayoutVscan tab btn. xml 


接 下 来 ,为 QR where 的 启动 界面 MainActivity 定义 布局 文件 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 

< LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width- "fill parent" 
android:layout height = "fill parent" 
android:orientation = "vertical" 


<! -- 放置 每 个 Fragment 的 内 容 --> 

< FrameLayout 
android:layout width= "fill parent" 
android:layout height = "Odip" 
android:layout weight = "1" 
android:id- "(9 + id/realtabcontent"/^ 


<! -- 底部 菜单 --> 

« android. support. v4. app. FragnentTabHost 
android:layout width = "fill parent" 
android:layout height = "wrap content" 
android:background = "(Zdrawable/buttom back" 
android: id = "(Zandroid:id/tabhost"» 


< FrameLayout 
android: layout width= "Odp" 
android:layout height = "Odp" 
android:layout weight - "0" 
android: id = "(Zandroid:id/tabcontent"/» 


«/android. support. v4. app. FragnentTabHost > 


«/LinearLayout > 
代码 文件 : codes\11\11.2\QR whereVresMlayoutNactivity main. xml 
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有 了 以 上 的 界面 布局 基础 , 便 可 以 实现 QR where 启动 界面 的 Java 程序 了 ,新 建 类 文 
ft. MainActivity. java。 为 了 在 MainActivity 中 加 载 各 个 菜单 项 所 对 应 的 Fragment, 需 要 让 
MainActivity 继承 FragmentActivity。 在 MainActivity 中 ,需要 实现 底部 菜单 栏 ,因此 , 需 
要 在 MainActivity 类 中 声明 以 下 几 个 变量 ,用 于 存放 必要 的 参数 。 


private FragmentTabHost tabHost; 

private LayoutInflater layoutInflater; 

// 定 义 数组 来 存放 Fragment 界面 

(& SuppressWarnings("rawtypes") 

private Class fragmenthrr [ ] =  (  ScanFragnment. class,  HistoryFragment. class, 
GeneratorFragment.class, SettingFragnment.class }; 

// 定 义 数组 来 存放 底部 按钮 图 片 

private int tablmageArr[ ] = { R. drawable. scan tab btn, R. drawable. history tab btn, R. 
drawable.generator tab btn, R.drawable.setting tab btn }; 

// 定 义 数组 来 存放 底部 选项 卡 文字 

//private int tabTextArr[ ] = (R. string. scan, R. string. history, R. string. generator, R. 
string.setting); 


private String tabTextArr[] = ( "scan", "history", "generator", 


在 MainActivity 中 ,我 们 主要 是 靠 以 下 的 两 个 方法 来 实现 底部 菜单 栏 的 。 


/** 
* 实现 底部 菜单 
*/ 
private void initBottomMenu() { 
// 实 例 化 布局 对 象 
layoutInflater = LayoutInflater.from(this); 
tabHost = (FragmentTabHost) this. findViewById(android.R. id. tabhost) ; 
tabHost.setup(this, getSupportFragmentManager(), R. id. realtabcontent); 
int count = fragnentArr. length; 
for (inti = 0; i< count; i++) ( 
// 调 用 getTabItenView 方法 为 每 一 个 Tab 按钮 设置 图 标 文字 
TabSpec tabSpec = tabHost. newTabSpec (tabTextArr[i]).setIndicator(getTabItenView(i)); 
tabHost.addTab(tabSpec, fragmentArr[i], null); 
tabHost. getTabWidget ( ). getChildAt(i). setBackgroundResource (R. drawable. selector _ 
tab background); 
) 


setting" }; 


) 


/ xx 
* 给 Tab 按钮 设置 图 标 和 文字 
*/ 
private View getTabItemView( int index) { 
// 加 载 底部 菜单 布局 ,在 该 布局 中 只 放置 了 存放 底部 菜单 图 标的 ImageView, 并 没有 在 图 标 下 方 
放置 文本 组 件 ， 
// 所 以 在 底部 菜单 的 图 标 下 方 并 没有 显示 菜单 文字 
View view = layoutInflater. inflate(R.layout.tab item view, null); 
ImageView imageView = (ImageView) view.findViewById(R. id. imageview); 
imageView. setImageResource(tabImageArr[index]); 
return view; 
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上 面 的 程序 通过 加 载 MainActivity 所 对 应 的 界面 布局 activity main. xml, 加 载 布 局 中 
所 对 应 的 FragmentTabHost 对 象 , 即 第 一 张 代码 片段 的 图 片 中 所 声明 的 第 一 个 变量 
tabHost。 通 过 循环 存放 了 底部 菜单 所 对 应 的 Fragment 的 数组 变量 fragmentArr, 调 用 
getTabltemView 方法 为 每 一 个 Tab 按钮 设置 图 标 文字。 在 该 方法 中 ,通过 加 载 底 部 菜单 
的 样式 文件 scan_tab_btn. xml, 得 到 底部 每 个 菜单 所 对 应 的 图 标 组 件 Image View ,并 为 其 设 
置 对 应 的 Image 资源 , 即 存 放 了 底部 按钮 图 片 的 变量 tabImageArr 中 所 存放 的 drawable Vt 
源 文件 。 以 tabImageArr 数组 中 的 第 一 个 元 素 R. drawable. scan_tab_btn Jy ffl : 


«?xml version= "1.0" encoding = "utf - 8"?> 
< selector xmlns:android = "http://schemas. android. com/apk/res/android"> 


< item android: drawable = " @ drawable/scan selected item" android: state selected = 
"true" /» 
< item android:drawable = "(drawable/scan item"/» 


«/selector» 
代码 文件 : codes\11\11.2\QR whereVresVdrawableVscan tab btn.xml 

在 该 drawable 资源 文件 中 ,定义 了 选项 选中 时 所 对 应 的 样式 以 及 选项 未 选中 时 所 对 应 
的 样式 ,也 就 是 说 ,通过 以 上 资源 文件 ,实现 当选 中 底部 菜单 栏 中 的 第 一 个 菜单 时 ,第 一 个 菜 
单 图标 将 是 图 片 文件 scan_selected_item ,该 图 片 是 一 张 背 景 颜色 为 黄色 的 png 图 片 , 当选 
中 其 他 菜单 项 时 ,第 一 个 菜单 按钮 将 失去 焦点 ,不 再 是 选中 状态 , 则 第 一 个 菜单 按钮 所 对 应 
的 图 标 显示 为 图 片 文件 scan_item ,该 图 片 是 一 张 背 景 颜色 为 黑色 的 png 图 片 ,该 图 片 与 
scan selected item. png 除了 图 片 颜色 不 一 样 之 外 ,其 他 都 一 样 。 

因此 ,需要 为 底部 四 个 菜单 按钮 分 别 准备 两 张 除了 颜色 不 一 样 ,其 他 完全 一 样 的 图 片 ， 
然后 分 别 定制 类 似 于 scan_tab_btn. xml 这 种 资源 文件 , 供 程 序 中 为 底部 菜单 按钮 设置 
drawable 资源 。 实 现 底部 菜单 项 选中 与 未 选中 时 显示 不 同 的 按钮 颜色 。 其 他 菜单 按钮 所 
对 应 的 drawable 资源 文件 ,可 以 通过 本 书 附 带 源码 ,去 scan_tab_btn. xml 所 在 的 文件 夹 目 
录 下 寻找 获得 。 

通过 以 上 介绍 的 MainActivity 类 中 的 initBottomMenu( ) 方 法 以 及 get TabItemView 
Gnt index) 方 法 ,已 经 实现 了 QR. where 底部 菜单 栏 以 及 选中 任意 菜单 项 后 的 跳 转 。 对 于 
各 个 菜单 项 所 对 应 的 Fragment, 则 将 在 接 下 来 的 章节 中 进行 介绍 。 

根据 QR where 的 功能 需求 ,我们 知道 ,在 Scan 菜单 所 对 应 的 Fragment 中 的 左上 角 有 
一 个 相册 按钮 , 单 击 该 按钮 ,将 会 调 出 系统 相册 ,选中 任意 一 张 图 片 , 将 会 返回 到 
MainActivity 中 ,在 MainActivity 中 对 返回 的 图 片 进行 二 维 码 解析 。 因 此 ,在 MainActivity 
类 中 需要 重 写 Activity 的 onActivityResult(int requestCode，int resultCode. Intent data) 
方法 。 下 面 给 出 整个 MainActivity 类 的 源码 : 


package net. takewin. qrwhere. activity; 
import java.util.Hashtable; 


import net. takewin. qrwhere. R; 
import net. takewin. qrwhere. fragment. GeneratorFragnent; 
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import net. takewin. qrwhere. fragment.HistoryFragment; 
import net. takewin. qrwhere. fragment. ScanFragment; 
import net. takewin. qrwhere. fragment. SettingFragment; 
import net. takewin. qrwhere. util. CommonUtil; 

import net. takewin. qrwhere. util. DBManager; 

import net. takewin. qrwhere. view. MyScanDialog; 

import net. takewin. qrwhere. zxing. decoding. RGBLuminanceSource; 
import android. app. Dialog; 

import android. app. ProgressDialog; 

import android. content. Intent; 

import android. database. Cursor; 

import android. graphics. Bitmap; 

import android. graphics. BitmapFactory; 

import android. os. Bundle; 

import android. os. Handler; 

import android. os. Message; 

import android. provider. MediaStore; 

import android. support. v4. app. FragnentActivity; 
import android. support. v4. app. FragnentTabHost; 
import android. text. TextUtils; 

import android. util.Log; 

import android. view. Layout Inflater; 

import android. view. View; 

import android. widget. ImageView; 

import android. widget. TabHost. TabSpec; 


import com. google. zxing. BinaryBitmap; 

import com. google. zxing. ChecksumException; 
import com. google. zxing.DecodeHintType; 

import com. google. zxing.FormatException; 

import com. google. zxing. NotFoundException; 
import com. google. zxing. Result; 

import com. google. zxing. common. HybridBinarizer; 
import com. google. zxing. qrcode. QRCodeReader ; 


public class MainActivity extends FragnentActivity ( 
private FragmentTabHost tabHost; 
private LayoutInflater layoutInflater; 
// 定 义 数组 来 存放 四 个 菜单 项 所 对 应 的 Fragment 
(& SuppressWarnings("rawtypes") 


private Class fragmentàrr [ ] = { ScanFragment. class, HistoryFragment. class, 
GeneratorFragment.class, SettingFragnent. class }; 
// 定 义 数组 来 存放 底部 按钮 图 片 


private int tabImageArr[] = { R. drawable. scan_tab_btn, R. drawable. history_tab_btn, R. 
drawable.generator tab btn, R. drawable. setting_tab_btn }; 

// 定 义 数组 来 存放 底部 选项 卡 文字 

private String tabTextArr[] = { "scan", "history", "generator", "setting" }; 


// 下 面 声明 打开 手机 相册 利用 zxing 扫描 的 相关 变量 
private static final int REQUEST CODE = 100; 
private ProgressDialog mProgress; 
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private Bitmap scanBitmap; 

private String photo_path; 

private static final int PARSE_BARCODE SUC = 300; 
private static final int PARSE_BARCODE FAIL = 303; 
// 8} MainActivity. dbManager Xj $& 

public static DBManager dbManager; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R. layout. activity main); 
// 创 建 MainActivity.dbManager 对 象 ， 
// 各 个 Fragment 将 调用 该 dbManager 实现 数据 库 操 作 
dbManager = new DBManager(MainActivity. this); 
initBottonMenu(); // 实 现 底部 菜单 


(QOverride 
protected void onActivityResult(int requestCode, int resultCode, Intent data) ( 
super.onActivityResult(requestCode, resultCode, data); 
if (resultCode == RESULT OK) ( 
switch (requestCode) ( 
case REQUEST CODE: 
// 获 取 选 中 图 片 的 路 径 
Cursor cursor = MainActivity. this. getContentResolver(). query(data. getData( ), 
null, null, null, null); 
if (cursor.moveToFirst()) ( 
photo path = cursor. getString (cursor. getColumnIndex ( MediaStore. 
Images.Media.DATA)); 
) 
cursor. close(); 
mProgress = new ProgressDialog(MainActivity. this); 
nProgress. setMessage( "正在 扫描 .…."); 
mProgress. setCancelable(false); 
mProgress. show() ; 


new Thread(new Runnable() ( 
// 由 于 在 线程 中 ,所 以 需要 利用 Handler 机 制 实现 UI 操作 ， 
@Override // 例 如 弹出 对 话 框 或 页 面 跳 转 
public void run() { 
// 解 析 返 回 的 图 片 , com. google. zxing. Result 对 象 result 中 包含 了 二 维 
码 文本 内 容 
Result result = scanningImage(photo path); 
if (result != null) ( ”// 表 示 解 析 成 功 
Message m = mHandler. obtainMessage(); 
m.what = PARSE BARCODE SUC; 
m.obj 7 result.getText(); 
mHandler. sendMessage(m) ; 
) else ( / /f& Wr A K 
Message m = mHandler. obtainMessage(); 
m.what - PARSE BARCODE FAIL; 
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m.obj = "Scan failed!"; 
mHandler. sendMessage(m) ; 


/xx 
* 传人 图 片 路 径 , 对 该 图 片 进行 解析 , 
* 若是 二 维 码 图 片 并 且 解 析 成 功 , 则 返回 对 应 的 com. google. zxing. Result 对 象 ， 
* 若 不 是 二 维 码 图 片 或 其 他 原因 造成 的 解析 失败 , 则 返回 null 
*/ 
private Result scanningImage(String path) { 
if (TextUtils. isEmpty(path)) { 
return null; 
) 
Hashtable < DecodeHint/Iype, String» hints = new Hashtable < DecodeHintlype, String»(); 
hints. put(DecodeHintType. CHARACTER SET, "UTF8"); // 设 置 二 维 码 内 容 的 编码 


BitmapFactory. Options options = new BitmapFactory.Options(); 


options.inJustDecodeBounds = true; // 先 获取 原 大 小 
scanBitmap = BitmapFactory.decodeFile(path, options); 
options. inJustDecodeBounds = false; // 获 取 新 的 大 小 


int sampleSize = (int) (options.outHeight / (float) 200); 
if (sampleSize <= 0) 
sampleSize = 1; 
options.inSampleSize = sampleSize; 
scanBitmap = BitmapFactory.decodeFile(path, options); 
RGBLuminanceSource source = new RGBLuminanceSource(scanBitmap); 
BinaryBitmap bitmapl = new BinaryBitmap(new HybridBinarizer(source)); 
QRCodeReader reader - new QRCodeReader(); 
try ( 
return reader.decode(bitmapl, hints); 
) catch (NotFoundException e) ( 
e. printStackTrace() ; 
) catch (ChecksumException e) ( 
e. printStackTrace(); 
) catch (FormatException e) { 
e. printStackTrace() ; 
) 
return null; 


private Handler mHandler - new Handler() ( 
@Override 
public void handleMessage(Message msg) { 
super. handleMessage(msg) ; 
mProgress.dismiss(); 
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Switch (msg.what) { 
case PARSE BARCODE SUC: 


// 根 据 不 同 的 文本 内 容 , 保 存 数据 记录 到 history 表 中 并 跳 转 到 不 同类 型 的 页 面 
onResultHandler((String) msg. obj, scanBitmap); 


break; 
case PARSE BARCODE FAIL: 
doDialog(); // 弹 出 对 话 框 
break; 
} 
} 
n 
/ xx 
* 根据 解析 出 来 的 文本 内 容 ,实现 保存 数据 记录 到 history 表 中 并 跳 转 到 不 同 的 页 面 
*/ 


private void onResultHandler(String resultString, Bitmap bitmap) { 
if (TextUtils. isEmpty(resultString)) { 
doDialog(); 
return; 
) 
Intent intent - null; 
if (CommonUtil. isURL(resultString)) ( 
Bundle bundle = new Bundle(); 
intent = new Intent(MainActivity.this, ScanResultActivity. class); 
bundle. putString("class", "ScanFragment"); 
bundle. putString( "result", resultString); 
intent. putExtras(bundle); 
) eise if (resultString. contains("BEGIN:VCARD")) ( 
String[] contentis - null; 
contentis = resultString. split("\r\n"); 
if (contentls.length» 1) ( 
) eise ( 
contentis = resultString. split(" Mn"); 
) 
String nameStr - "", phoneStr - "", emailStr - "", companyStr - "", titleStr 
"", addressStr = "", websiteStr = ""; 
for (String content : contentis) { 
if (content.contains("FN:")) ( 
String[] name = content.split(":"); 
nameStr - name[1]; 


) 

if (content.contains("TEL:")) { 
String[] phone = content. split(":"); 
phoneStr - phone[1]; 

) 

if (content.contains("EMAIL:")) ( 
String[] email = content. split(":"); 
emailStr - email[1]; 

) 

if (content.contains("ORG:")) { 
String[] company = content. split(":"); 
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companyStr = company[1]; 

) 

if (content.contains("TITLE:")) ( 
String[] title = content.split(":"); 
titleStr - title[1]; 

) 

if (content.contains("ADR:")) ( 
String[] address = content. split(":"); 
addressStr = address[1]; 

) 

if (content.contains("URL:")) ( 
String[] website = content.split(":"); 
websiteStr = website[1]; 


) 


intent = new Intent(MainActivity.this, ContactDetailActivity.class); 


intent. putExtra("all", resultString); 
intent, putExtra("name", nameStr); 
intent.putExtra("phone", phoneStr); 
intent.putExtra("email", emailStr); 
intent.putExtra("company", companyStr); 
intent.putExtra("title", titleStr); 
intent.putExtra("address", addressStr); 
intent.putExtra("website", websiteStr); 
intent.putExtra("contentl", resultString); 

) eise if (resultString.contains("geo:")) ( 
String[] locations = resultString. split(":"); 
locations = locations[1].split(","); 

String lat = locations[0]; 

locations = locations[1].split("[?]"); 
String lon = locations[0]; 

String nameStr - "Geo:" * lat * "," * lon; 


intent = new Intent(MainActivity. this, MapResultActivity.class); 


intent.putExtra("flag", "scan"); 

intent.putExtra("title", nameStr); 

intent.putExtra("contentl", resultString); 

intent. putExtra("lat", lat); 

intent.putExtra("lon", lon); 

if (locations != null && locations. length» 1) { 
locations = locations[1].split(" ="); 
String qStr = locations[1]; 
intent.putExtra("q", qStr); 

) 

) else if (resultString.contains("WIFI:")) { 
Log. i("wifiStr", resultString); 


intent = new Intent(MainActivity. this, WifiResultActivity. class); 


Bundle bundle = new Bundle(); 
bundle. putString( "class", "ScanFragment"); 
bundle. putString( "result", resultString); 
intent. putExtras(bundle); 

) eise if (resultString. contains("BEGIN:VEVENT")) ( 


第 11 章 ”二 维 码 应 用 一 一 QR where fus) 


intent = new Intent(MainActivity.this, CalendarDetailActivity.class); 
Bundle bundle = new Bundle(); 
bundle. putString("class", "scan"); 
bundle. putString("calendar", resultString); 
intent. putExtras( bundle); 
} else { 
intent = new Intent(MainActivity. this, ElseDetailActivity. class); 
Bundle bundle = new Bundle(); 
bundle. putString("class", "scan"); 
bundle. putString("else", resultString); 
intent. putExtras( bundle); 
} 
MainActivity. this. startActivity(intent); 


/** 
* 弹出 对 话 框 显示 No barcode detected. (未 检测 到 的 条 形 码 。) 
*/ 
private void doDialog() { 
Dialog dialog = new MyScanDialog(MainActivity.this, R. style. MyScanDialog); 
dialog. show(); 


/** 
* 实现 底部 菜单 
*/ 
Private void initBottomMenu() { 
// 实 例 化 布局 对 象 
layoutInflater = LayoutInflater. from(this); 
tabHost = (FragmentTabHost) this. findViewById(android.R. id. tabhost) ; 
tabHost.setup(this, getSupportFragmentManager(), R. id.realtabcontent); 
int count = fragnentArr. length; 
for (inti = 0; i< count; i++) ( 
// 调 用 getTabItenView 方法 为 每 一 个 Tab 按钮 设置 图 标 ,文字 
TabSpec tabSpec = tabHost.newTabSpec(tabTextArr[i]).setIndicator 
(getTabItemView(i)); 
tabHost.addTab(tabSpec, fragmentArr[i], null); 
tabHost. getTabWidget().getChildAt(i).setBackgroundResource(R. drawable. 
selector tab background); 


/ xx 
* 给 Tob 按钮 设置 图 标 和 文字 
*/ 
private View getTabItemView(int index) { 
// 加 载 底 部 菜单 布局 ,在 该 布局 中 只 放置 了 存放 底部 菜单 图 标的 ImageView, 并 没有 在 图 标 
下 方 放置 文本 组 件 ， 
// 所 以 在 底部 菜单 的 图 标 下 方 并 没有 显示 菜单 文字 
View view = layoutInflater. inflate(R.layout.tab item view, null); 
ImageView imageView = (ImageView) view.findViewById(R. id. imageview); 
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imageView. setImageResource(tabImageArr[index]); 
return view; 


) 
代码 文件 : codes\11\11.2\QR where\cn\edu\hstc\qrwhere\activity\MainActivity. java 


上 面 程序 重 写 了 onActivityResult(int requestCode, int resultCode, Intent data) 方 法 ， 

在 该 方法 中 实现 获取 选中 图 片 的 路 径 , 当 然 , 调 出 系统 相册 功能 则 是 放 在 了 第 一 个 菜单 项 所 
对 应 的 Fragment 中 去 实现 的 。 在 此 ,我 们 先 不 用 关心 此 处 代码 实现 。 获 取 选 中 图 片 的 路 
径 后 ,弹出 一 个 进度 条 ProgressDialog 提示 用 户 “ 正 在 扫描 ...”, 同 时 开启 一 个 线程 ,在 该 线 
程 中 调用 scanninglmageCString path) 方 法 ,传人 选中 图 片 路 径 ,对 该 图 片 进行 二 维 码 解析 。 

当前 市 面 上 主流 的 二 维 码 扫 描 和 解析 、 生 成 的 框架 有 ZBar 框架 以 及 谷歌 的 开源 ZXing 
框架 。QR where 同时 使 用 了 这 两 个 框架 。 为 了 使 用 ZBar 和 ZXing 框架 ,读者 需要 到 官方 
下 载 ZBar 和 ZXing 源码 库 ,并 将 zbar. jar.zxing. jar 添加 到 项 目 libs 路 径 下 。 在 本 书 所 附 
带 QR where 的 源码 项 目 中 ,自然 也 已 经 包含 了 zbar. jar、zxing. jar, 读 者 可 以 直接 将 这 两 个 
jar 包 集成 到 其 他 需要 利用 ZBar 或 ZXing 开发 二 维 码 应 用 的 项 目 中 。 在 QR where 中 , 调 
用 手机 相册 返回 图 片 后 ,采用 的 是 ZXing 框架 对 图 片 进 行 二 维 码 解析 。 使 用 手机 摄像 头 直 
接 扫描 二 维 码 后 则 是 采用 ZBar 框架 对 其 进行 解析 。 本 应 用 中 同时 使 用 了 ZBar 以 及 
ZXing, 目 的 就 是 为 了 能 让 读者 通过 本 应 用 同时 了 解 市 面 上 这 两 大 主流 的 二 维 码 和 条 形 码 
识别 工具 。 

在 二 维 码 解析 的 方法 scanningImageCString path) 中 ,根据 传 入 的 图 片 路 径 , 生 成 一 个 
android. graphics. Bitmap 对 象 scanBitmap 。 而 二 维 码 解析 这 部 分 的 真正 实现 , 则 是 通过 继 
承 了 com. google. zxing. LuminanceSource 的 RGBLuminanceSource 类 以 及 com. google. 
zxing. qrcode. QRCodeReader 的 配合 来 完成 的 。RGBLuminanceSource 类 用 于 帮助 图 像 文 
件 到 Android 位 图 的 RGB 数据 的 解码 ,该 类 的 源码 在 此 处 不 作 展示 ,读者 可 以 通过 本 书 附 
带 源码 获得 。 程 序 中 调用 com. google. zxing. qrcode. QRCodeReader 的 decode 方法 返回 了 
一 个 com. google. zxing. Result 对 象 ,在 该 对 象 中 包含 了 解析 出 来 的 二 维 码 文本 内 容 。 若 图 
片 中 不 包含 二 维 码 信息 ,或 其 他 原因 所 造成 的 解析 异常 , 则 方法 返回 null。 具 体 的 二 维 码 解 
析 操 作 ,请 参见 程序 中 的 Result scanningImage(String path) 方 法 。 

由 于 程序 使 用 线程 来 调用 scanningImage(String path) 方 法 操作 二 维 码 的 解析 ,在 子 线 
程 中 不 能 直接 操作 UI 主线 程 。 因 此 ,需要 利用 Android Handler 机 制 ,根据 解析 出 来 的 不 
同 结果 ,实现 不 同 的 操作 。 在 Handler 类 的 实现 中 ,停止 了 进度 条 使 其 消失 ,并 根据 解析 结 
果 的 不 同 进行 不 同 的 操作 。 程 序 实现 当 解析 异常 时 ,弹出 一 个 对 话 框 提示 用 户 未 检测 到 的 
条 形 码 。 如 果 解 析 成 功 , 则 会 调用 onResultHandler 方法 ,根据 解析 出 来 的 不 同文 本 ,对 文 
本 进行 不 同 的 包装 处 理 , 然 后 传人 消息 传递 类 Bundle 的 对 象 中 , 带 着 Bundle 数据 跳 转 到 包 
括 URL, Contact, Location, WiFi 四 种 不 同类 型 的 详情 界面 中 或 跳 转 到 一 个 普通 的 页 面 显 
示 文 本 以 及 二 维 码 。 具 体 实 现 请 参照 程序 中 的 onResultHandler (String resultString， 
Bitmap bitmap) 方 法 。 至 于 带 着 这 些 文本 信息 跳 转 后 的 详情 页 面 ,我 们 暂且 不 用 关心 ,后 面 
将 会 具体 介绍 。 
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(1.3 开发 第 一 个 菜单 项 所 对 应 的 界面 ScanFragment 


根据 上 面 功能 需求 的 介绍 ,我 们 了 解 到 ,在 第 一 个 菜单 项 所 对 应 的 界面 中 ,在 左上 角 放 
置 了 一 个 相册 按钮 用 于 调 出 手机 系统 自 带 的 相册 ,右上 角 放 置 了 一 个 按钮 用 于 打开 或 关闭 


手机 闪光 灯 功 能 。 然 后 ， 


我 们 还 需要 根据 其 业务 ,在 屏幕 的 中 间 放 置 一 个 手机 摄像 头 预览 


区 ,该 区 域 由 SurfaceView 来 完成 。SurfaceView 可 以 直接 从 内 存 或 者 DMA 等 硬件 接口 取 
得 图 像 数据 ,是 非常 重要 的 绘图 容器 。 也 就 是 说 ,SurfaceView 可 以 将 手机 摄像 头 所 捕捉 到 
的 画面 绘制 进去 。 还 需要 在 界面 中 放置 一 个 自 定 义 的 View 组 件 ,该 View 组 件 称 为 
FinderView ,继承 自 View 类 ,该 自 定 义 类 主要 用 于 在 界面 中 画 出 扫描 框 。ScanFragment 
所 对 应 的 界面 布局 代码 如 下 : 


< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android:layout width = "match parent" 


android:layout height = "match parent" 
android:background = "(2 color/white" 
android:orientation = "vertical" > 


<! -- 顶部 标题 --> 


< RelativeLayout 


android:layout width= "fill parent" 
android:layout height = "wrap content" 
android:background = "(2 color/backhost" 
android:padding = "10dip" > 


< ImageView 


android: 
android: 
android: 
android: 
android: 
android: 


< TextView 


android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 
android: 


< InmageView 


android: 


id- "(à + id/getPhotolmageView" 
layout width = "wrap content" 
layout height = "wrap content" 
layout alignParentLeft - "true" 
layout centerVertical - "true" 
src = "(Üdrawable/camera" /> 


id= "@ + id/titleTextView" 
layout width- "wrap content" 
layout height = "wrap content" 
layout centerHorizontal = "true" 
layout centerVertical = "true" 
paddingTop = "10dp" 
paddingBottom = "10dp" 

text = "@ string/scan" 

textColor = "(Zcolor/white" 
textSize = "20sp" /> 


id- "(8 + id/openFlashLampImageView" 


348 ”Android 应 用 开发 从 入 门 到 精通 


android: layout width= "wrap content" 

android:layout height = "wrap content" 

android:layout alignParentRight - "true" 

android:layout centerVertical - "true" 

android:src = "(Qdrawable/flash" /> 
«/RelativeLayout > 


<! -- 二 维 码 扫描 区 --> 

< FrameLayout 
android:layout width= "match parent" 
android:layout height = "match parent" > 


< SurfaceView 
android: id = "@ + id/surface view" 
android: layout width= "match parent" 
android:layout height = "match parent" /> 


< net. takewin. qrwhere. view. FinderView 
android:id- "(à + id/finder view" 
android:layout width = "match parent" 
android:layout height = "match parent" /» 
«/FrameLayout > 


«/LinearLayout > 
代码 文件 : codes\11\11.2\QR whereVresMayoutVactivity scan. xml 


以 上 布局 文件 使 用 了 一 个 自 定 义 的 View 组 件 FinderView ,该 FinderView 源码 如 下 : 
package net. takewin. qrwhere. view; 


import net. takewin. qrwhere. R; 

import android. content. Context; 

import android. graphics. Canvas; 

import android. graphics. Paint; 

import android. graphics. Rect; 

import android. graphics. drawable. Drawable; 
import android. util. AttributeSet; 

import android. view. View; 


public class FinderView extends View { 
private static final long ANIMATION DELAY - 30; 
private Paint finderMaskPaint; 
private int measureedWidth; 
private int measureedHeight; 


public FinderView(Context context) { 


super(context); 
init(context); 


public FinderView(Context context, AttributeSet attrs) ( 
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super(context, attrs); 
init(context); 


(QOverride 
protected void onDraw(Canvas canvas) ( 
super. onDraw(canvas) ; 
/ /canvas. drawRect(leftRect, finderMaskPaint); 
/ canvas. drawRect(topRect, finderMaskPaint); 
/ canvas. drawRect(rightRect, finderMaskPaint); 
//canvas. drawRect(bottomRect, finderMaskPaint); 
/ / ii fte 
zx code kuang. setBounds(middleRect); 
zx code kuang.draw(canvas); 
if (lineRect. bottom < middleRect. bottom) ( 
zx code line. setBounds(lineRect); 
lineRect.top = lineRect.top + lineHeight / 2; 
lineRect.bottom = lineRect.bottom + lineHeight / 2; 
) eise ( 
lineRect. set(middleRect); 
lineRect.bottom - lineRect.top * lineHeight; 
zx code line. setBounds(lineRect); 
} 
//zx code line.draw(canvas); 
postlInvalidateDelayed(ANIMATION DELAY, middleRect.left, middleRect.top, middleRect. 
right, middleRect. bottom); 
) 


private Rect topRect - new Rect(); 
private Rect bottomRect - new Rect(); 
private Rect rightRect - new Rect(); 
private Rect leftRect = new Rect(); 
private Rect middleRect - new Rect(); 


private Rect lineRect = new Rect(); 
private Drawable zx code kuang; 
private Drawable zx code line; 
private int lineHeight; 


private void init(Context context) { 
int finder mask = context.getResources().getColor(R.color.finder mask); 
finderMaskPaint = new Paint(Paint. ANTI ALIAS FLAG); 
finderMaskPaint.setColor(finder mask); 
zX code kuang = context. getResources( ) . getDrawable(R. drawable. scan view); 
zx_code_kuang. setAlpha(110); 
zx code line = context.getResources().getDrawable(R.drawable.zx code line); 
lineHeight = 30; 


L1111111111111 新 增 该 方法 111111111111111111111/ 
/xx 
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* 根据 图 片 size 求 出 矩形 框 在 图 片 所 在 位 置 , cip: 相机 旋转 90 度 以 后 , 拍摄 的 图 片 是 横着 
的 ,所 有 传递 参数 时 ,做 了 交换 

* (param w 

* (param h 

* @return 


*/ 


public Rect getScanImageRect(int w, int h) { 
// 先 求 出 实际 矩形 
Rect rect = new Rect(); 
rect. left = middleRect.left; 
rect.right - middleRect.right; 
float temp = h / (float) measureedHeight; 
rect.top = (int) (middleRect.top * temp); 
rect.bottom - (int) (middleRect.bottom * temp); 
return rect; 


HUM P P HL P MH GG g 14 

@Override 

protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) { 
super.onMeasure(widthMeasureSpec, heightMeasureSpec); 


measureedWidth = MeasureSpec.getSize(widthMeasureSpec); 

measureedHeight = MeasureSpec.getSize(heightMeasureSpec); 

int borderWidth = measureedWidth / 2 + 100; 

middleRect.set((measureedWidth — borderWidth) / 2, (measureedHeight - borderWidth) / 2, 
(measureedWidth - borderWidth) / 2 + borderWidth, (measureedHeight - borderWidth) / 2 + 
borderWidth); 

lineRect. set(middleRect); 

lineRect.bottom - lineRect.top * lineHeight; 

leftRect.set(0, middleRect.top, middleRect.left, middleRect. bottom); 

topRect.set(0, 0, measureedWidth, middleRect. top); 

rightRect. set(middleRect. right, middleRect. top, measureedWidth, middleRect. bottom); 

bottomRect.set(0, middleRect.bottom, measureedWidth, measureedHeight); 


代码 文件 : codes\11\11.2\QR where\cn\edu\hstc\qrwhere\view\FinderView. java 
上 面 的 程序 自 定义 了 一 个 继承 自 android. view. View 的 类 FinderView, 该 类 重 写 了 


onDraw(Canvas canvas) 方 法 , 画 出 了 一 个 取景 框 ,二 维 码 扫 描 框 就 是 依靠 这 个 类 夯 出 来 的 。 
接 下 来 ,直接 看 看 第 一 个 菜单 项 所 对 应 的 Fragment 的 实现 源码 : 


package net. takewin. qrwhere. fragnent; 


import net. 
import net. 
import net. 
import net. 
import net. 
import net. 
import net. 
import net. 


sourceforge. zbar. Conf ig; 

sourceforge. zbar. Image; 

sourceforge. zbar. ImageScanner; 

sourceforge. zbar. Symbol; 

sourceforge. zbar. SymbolSet; 

takewin. qrwhere. R; 

takewin. qrwhere. activity. CalendarDetailActivity; 
takewin. qrwhere. activity. ContactDetailActivity; 


import net. 
import net. 
import net. 
import net. 
import net. 
import net. 


import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 


takewin. qrwhere. 
takewin. qrwhere. 
takewin. qrwhere. 
takewin. qrwhere. 
takewin. qrwhere. 


activity.ElseDetailActivity; 
activity.MapResultActivity; 
activity.ScanResultActivity; 
activity.WifiResultActivity; 
util.CommonUtil; 


takewin. qrwhere. view. FinderView; 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 


content. Intent; 

content. pm. FeatureInfo; 
content. pm. PackageManager; 
graphics. Rect; 

hardware. Camera; 

hardware. Camera. AutoFocusCallback; 
hardware. Camera. Parameters; 
hardware. Camera. PreviewCallback; 
hardware. Camera. Size; 

os. AsyncTask; 

os. Bundle; 

os. Handler; 

support. v4. app. Fragment; 
util.Log; 

view. LayoutInflater; 

view. SurfaceHolder; 

view. SurfaceView; 

view. View; 

view. ViewGroup; 

widget. ImageView; 

widget. Toast; 
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public class ScanFragment extends Fragment implements SurfaceHolder. Callback { 
private static String TAG = "xiaogiang"; 


private Camera mCamera; 


private SurfaceHolder mHolder; 


private SurfaceView surface view; 
private ImageScanner scanner; 
private Handler autoFocusHandler; 
private AsyncDecode asyncDecode; 
private FinderView finder view; 


private ImageView getPhotolmageView; 


private ImageView getFlashlImageView; 


private Parameters parameters = 
private static final int REQUEST CODE - 


null; 
100; 


private boolean flag, b; 


static ( 


System. loadLibrary("iconv"); 


(QOverride 


// 打 开 手 机 相册 按钮 
// 打 开 手 机 闪光灯 按钮 


public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) 


”351 


392 ' Android 应 用 开发 从 入 门 到 精通 


return inflater. inflate(R.layout.activity scan, null); 


(QOverride 
public void onActivityCreated(Bundle savedInstanceState) ( 
super. onActivityCreated(savedInstanceState); 


initView(); 


(QOverride 

public void onResume() { 
super. onResune( ) ; 
flag = true; 
b = true; 


private void initView() { 
surface view = (SurfaceView) getActivity().findViewById(R. id. surface view); 
finder view = (FinderView) getActivity().findViewById(R. id.finder view); 
mHolder = surface view.getHolder(); 
mHolder.setType(SurfaceHolder. SURFACE TYPE PUSH BUFFERS); 
mHolder.addCallback(this); 
Scanner = new ImageScanner(); 
scanner. setConfig(0, Config.X DENSITY, 3); 
scanner. setConfig(0, Config.Y DENSITY, 3); 
autoFocusHandler - new Handler(); 
asyncDecode = new AsyncDecode(); 
initGetPhotoImageView(); 
initGetFlashImageView(); 


private void initGetPhotoImageView() { 
getPhotolmageView = (ImageView) getActivity().findViewById(R. id. 
getPhotolmageView); 
getPhotolmageView. setOnClickListener(new View.OnClickListener() ( 
@Override 
Public void onClick(View v) { 
// 打 开 手 机 中 的 相册 
Intent innerIntent = new Intent(Intent. ACTION GET CONTENT); //"android. 
intent. action. GET CONTENT" 
innerIntent. setType(" image/ * "); 
Intent wrapperIntent = Intent.createChooser(innerIntent, "选择 二 维 码 图 片 "); 
getActivity(). startActivityForResult(wrapperIntent, REQUEST CODE); 


n; 


private void initGetFlashImageView() { 
getFlashlmageView = (ImageView) getActivity().findViewByld(R. id. 
openFlashLampImageView); 
getFlashImageView. setOnClickListener(new View.OnClickListener() { 
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GOverride 
public void onClick(View v) ( 
PackageManager pm = ScanFragment. this. getActivity(). getPackageManager() ; 
FeatureInfo[] features = pm.getSystemAvailableFeatures(); 
for (FeatureInfo f : features) { 
if (PackageManager. FEATURE CAMERA FLASH. equals(f.name)) { 
if (mCamera != null) ( 
mCamera. startPreview(); 
parameters = mCamera.getParameters(); 
if (parameters. getFlashMode(). equals(Parameters. FLASH MODE 


OFF)) { 
parameters. setFlashMode( Parameters. FLASH MODE TORCH); 
mCamera. setParameters(parameters); 
) eise ( 
parameters. setFlashMode(Parameters. FLASH MODE OFF); 
mCamera. setParameters(parameters); 
} 
) eise ( 
Toast.makeText(getActivity(), "Fail to open the flash", 3000). 
show(); 
) 
} 
} 
} 
D; 
) 
(QOverride 


public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
if (mHolder.getSurface() == null) ( 
return; 
) 
try { 
if (mCamera != null) ( 
mCamera. stopPreview(); 
) 
) catch (Exception e) ( 
) 
try ( 
mCamera. setDisplayOrientation(90); 
mCamera. setPreviewDisplay(mHolder); 
mCamera. setPreviewCallback(previewCallback); 
mCamera. startPreview(); 
mCamera. autoFocus(autoFocusCallback); 
) catch (Exception e) ( 
Log.d("DBG", "Error starting camera preview: " * e.getMessage()); 
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x*/ 
PreviewCallback previewCallback = new PreviewCallback() { 
public void onPreviewFrame(byte[ ] data, Camera camera) ( 

if (asyncDecode. isStoped()) ( 
Camera. Parameters parameters = camera. getParameters(); 
Size size - parameters.getPreviewSize(); 
// 图 片 是 被 旋转 了 90 度 的 
Image source = new Image(size.width, size.height, "Y800"); 
Rect scanlmageRect = finder view.getScanImageRect(size. height, size. width); 
// 图 片 旋转 了 90 度 , 将 扫描 框 的 TOP 作为 left 裁剪 
source. setCrop( scanImageRect. top，scanImageRect. left, scanImageRect. 
bottom, scanImageRect. right); 
source. setData(data); 
asyncDecode - new AsyncDecode(); 
asyncDecode. execute( source) ; 


}; 


private class AsyncDecode extends AsyncTask < Image, Void, Void» { 
private boolean stoped - true; 


private String str - ""; 

(QOverride 

protected Void doInBackground(Image... params) ( 
if (flag) ( 


stoped - false; 
StringBuilder sb = new StringBuilder(); 
Image barcode = params[0]; 
int result = scanner. scanImage(barcode); 
if (result != 0) ( 
SymbolSet syms = scanner.getResults(); 
for (Symbol sym : syms) ( 
switch (sym.getType()) ( 
case Symbol. CODABAR: 
Log. d(TAG, "条形码 " + sym.getData()); 
// 条 形 码 
sb.append( sym. getData() + "\n"); 
break; 
case Symbol. CODE128: 
//128 编码 格式 二 维 码 
Log.d(TAG, "128 编码 格式 二 维 码 : ”+ sym.getData()); 
sb.append(sym.getData() + "\n"); 
break; 
case Symbol. QRCODE: 
/ [QR 码 二 维 码 
Log. d(TAG, "QR 码 二 维 码 :" + sym.getData()); 
sb.append(sym.getData() + "Wn"); 
break; 
case Symbol. ISBN10: 
/ /1SBN10 图 书 查询 
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Log.d(TAG, "ISBN10 图 书 查询 : " + sym.getData()); 
sb.append(sym.getData() + "\n"); 
break; 
case Symbol. ISBN13: 
/ /1SBN13 图 书 查询 
Log.d(TAG, "ISBN13 图 书 查询 — : ”+ sym.getData()); 
sb.append(sym.getData() + "\n"); 
break; 
case Symbol. NONE: 
Log. d(TAG, "RAI :" + sym.getData()); 
sb. append(sym. getData() + "\n"); 
break; 
default: 
Log. d(TAG, "其 他 : " + sym.getData()); 
sb. append( sym. getData() + "\n"); 
break; 


} 
str = sb.toString(); 


} 


return null; 


@Override 

protected void onPostExecute(Void result) { 
super. onPostExecute(result); 
stoped = true; 
if (null == str || str.equals("")) ( 


} else { 
if (b) { 
b = false; 
Intent intent = null; 
Bundle bundle = new Bundle(); 


if (CommonUtil.isURL(str) == true) ( 
intent - new Intent(getActivity(), ScanResultActivity. class); 
bundle. putString( "class", "ScanFragment"); 
bundle. putString( "result", str); 
intent. putExtras( bundle); 
} else if (str.contains("BEGIN: VCARD") ) ( 
String[] contentis = null; 
contentis = str. split("\r\n"); 
if (contentls. length> 1) ( 
) eise ( 
contentis = str. split("\n"); 
} 
String nameStr = "", phoneStr = 
"", titleStr = "", addressStr = "", websiteStr = ""; 
for (String content : contentis) { 
if (content.contains("FN:")) ( 
String[] name = content. split(":"); 


mm mm 


, emailStr = , companyStr = 
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nameStr = name[1]; 

) 

if (content. contains("TEL:")) ( 
String[] phone = content. split(":"); 
phoneStr - phone[1]; 

) 

if (content.contains("EMAIL:")) ( 
String[] email - content. split(":"); 
emailStr = email[1]; 

) 

if (content.contains("ORG:")) ( 
String[] company = content. split(":"); 
companyStr = company[1]; 

} 

if (content.contains("TITLE:")) { 
String[] title = content. split(":"); 
titleStr - title[1]; 

} 

if (content. contains("ADR:")) { 
String[ ] address = content. split(":"); 
addressStr = address[1]; 

) 

if (content.contains("URL:")) ( 
String[] website 7 content. split(":"); 
websiteStr = website[1]; 

} 

} 


intent = new Intent(getActivity(), ContactDetailActivity. class); 
intent.putExtra("all", str); 
intent.putExtra("name", nameStr); 
intent.putExtra("phone", phoneStr); 
intent.putExtra("email", emailStr); 
intent.putExtra("company", companyStr); 
intent.putExtra("title", titleStr); 
intent.putExtra("address", addressStr); 
intent.putExtra("website", websiteStr); 
intent.putExtra("contentl", str); 

) else if (str.contains("geo:")) ( 
Log. i("location", str); 
String[] locations - str.split(":"); 
locations = locations[1].split(","); 
String lat = locations[0]; 
locations - locations[1].split("[?]"); 
String lon = locations[0]; 
String nameStr = "Geo:" + lat + "," + lon; 
intent = new Intent(getActivity(), MapResultActivity.class); 
intent.putExtra("flag", "scan"); 
intent.putExtra("title", nameStr); 
intent.putExtra("contentl", str); 
intent.putExtra("lat", lat); 
intent.putExtra("lon", lon); 
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if (locations != null && locations. length> 1) { 
locations = locations[1].split(" ="); 
String qStr - locations[1]; 
intent.putExtra("q", qStr); 
) 
} else if (str.contains("WIFI:")) ( 
intent = new Intent(getActivity(), WifiResultActivity.class); 
bundle. putString( "class", "ScanFragment"); 
bundle. putString( "result", str); 
intent. putExtras(bundle); 
} else if (str.contains("BEGIN:VEVENT")) ( 
intent = new Intent(ScanFragnment. this.getActivity(), 
CalendarDetailActivity.class); 
bundle = new Bundle(); 
bundle. putString("class", "scan"); 
bundle. putString("calendar", str); 
intent. putExtras( bundle); 
} else { 
intent = new Intent(ScanFragment. this.getActivity(), 
ElseDetailActivity. class); 
bundle = new Bundle(); 
bundle. putString("class", "scan"); 
bundle. putString("else", str); 
intent. putExtras(bundle); 
} 
getActivity(). startActivity( intent); 
flag = false; 


public boolean isStoped() { 
return stoped; 


/ xx 
* 自动 对 焦 回调 
*/ 
AutoFocusCallback autoFocusCallback = new AutoFocusCallback() { 
public void onAutoFocus(boolean success, Camera camera) { 
autoFocusHandler. postDelayed(doAutoFocus, 1000); 


// 自 动 对 焦 
private Runnable doAutoFocus = new Runnable() { 
public void run() { 
if (null == nCamera || null == autoFocusCallback) { 
return; 
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mCamera. autoFocus(autoFocusCallback); 


}; 


@Override 
public void surfaceCreated(SurfaceHolder holder) { 
try ( 
if (mCamera == null) { 


mCamera = Camera. open(); 
} 
} catch (Exception e) { 
mCamera = null; 
} 
} 


@Override 
public void surfaceDestroyed(SurfaceHolder holder) { 
if (mCamera != null) { 
mCamera. setPreviewCallback(null); 
mCamera. release(); 
mCamera = null; 


} 


代码 文件 : codes\11\11. 2\QR where\cn\edu\hstc\qrwhere\fragment\ScanFragment. java 


上 面 的 程序 实现 了 第 一 个 菜单 项 所 对 应 的 界面 。ScanFragment 类 需要 继承 Fragment 
Jf HI android. view. SurfaceHolder. Callback。 由 于 这 里 实现 的 是 一 个 Fragment, AIE 
需要 重 写 onCreateView 方法 ,并 在 该 方法 中 加 载 界面 布局 ,如 上 面 程序 中 的 代码 片段 : 


@Override 
public View  onCreateView ( LayoutInflater inflater, ViewGroup container, Bundle 
savedInstanceState) { 

return inflater. inflate(R. layout. activity_scan, null); 


) 


上 面 的 代码 片段 为 固定 写法 。 接 着 .程序 重 写 onActivityCreated 方法 ,在 该 方法 中 初 
始 化 所 有 界面 中 的 View 组 件 , 包 括 二 维 码 扫描 解析 操作 、 打 开 系 统 图 库 的 按钮 的 实现 、 打 
开 或 关闭 闪 关 灯 的 按钮 的 实现 。 

程序 调用 自 定义 方法 initGetPhotolImageView() ,实现 加 载 界 面 左 上 角 的 打开 系统 图 库 
的 按钮 并 为 其 添加 单 击 事件 监听 器 。 程 序 直接 调用 Android API 实现 打开 系统 图 库 的 操 
作 。 这 里 代码 行 getActivity ( ). startActivityForResult ( wrapperIntent, REQUEST _ 
CODE) 中 所 传人 的 REQUEST. CODE 需要 与 MainActivity 类 中 的 onActivityResultCint 
requestCode, int resultCode. Intent data) 方 法 中 的 REQUEST. CODE 相等 。 因 为 在 这 个 
方法 中 ,程序 将 会 检查 REQUEST CODE 是 否 是 之 前 传 给 startActivityForResult() 方 法 的 
REQUEST CODE. 如 是 , 则 做 出 相应 的 处 理 。 一 旦 用 户 选择 了 系统 图 库 中 的 图 片 ， 
MainActivity 类 中 的 onActivityResult 方法 将 会 被 调用 ,然后 处 理 所 得 到 的 数据 。 
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这 里 为 什么 可 以 在 ScanFragment 中 调用 startActivityForResult 方法 ,而 在 MainActivity 
中 的 onActivityResult 可 以 响应 呢 ? 那 是 因为 ScanFragment 始终 是 存在 于 MainActivity 
中 的 。 注 意 到 startActivityForResult ( wrapperlntent, REQUEST _ CODE) 是 通过 
getActivity() 获 取 父 容器 , 即 MainActivity 后 才能 调用 的 。 

程序 调用 自 定义 方法 initGetFlashImageView O ,实现 加 载 界面 右上 角 的 按钮 并 为 其 添 
加 单 击 事件 监听 器 。 程 序 也 是 通过 直接 调用 相关 Android API 操作 手机 硬件 ,实现 打开 或 
关闭 手机 闪 关 灯 功 能 。 

程序 中 还 实现 了 摄像 头 预览 ,摄像 头 自动 对 焦 、 自 动 对 焦 回 调 等 Android 多 媒体 功能 。 
读者 可 以 通过 阅读 源码 学 习 了 解 。 

程序 中 通过 异步 任务 ,实现 二 维 码 扫描 解析 操作 。 这 样 可 以 避免 摄像 头 预览 界面 卡 死 。 
在 预览 数据 时 ,生成 了 net. sourceforge. zbar. Image 对 象 ,将 该 对 象 作为 源 传人 异步 任务 的 
doInBackground 方法 中 ,在 该 方法 中 调用 net. sourceforge. zbar. ImageScanner 对 象 的 
scanImage(Image image) 方 法 ,该 方法 的 image 参数 正 是 预览 时 生成 的 net. sourceforge. 
zbar. Image 对 象 ,该 方法 正 是 ZBar 框架 对 二 维 码 扫 描 解 析 的 操作 。 从 代码 中 可 以 看 出 , 当 
scanImage 方法 所 返回 的 整 型 返回 值 不 为 零 时 ,代表 了 成 功 解析 , 则 调用 net. sourceforge. 
zbar. ImageScanner 对 象 的 getResults € ) 方 法 返回 结果 和 集 net. sourceforge. zbar. 
SymbolSet, 强 制 循环 该 结果 集 , 获 取 结 果 集 中 的 每 个 net. sourceforge. zbar. Symbol 对 象 ， 
判断 其 类 型 ,包括 条 形 码 、128 编码 格式 二 维 码 、QR 码 二 维 码 、ISBN10 图 书 查询 .ISBN13 
图 书 查询 等 类 型 ; 然后 通过 Symbol 对 象 的 getData() 方 法 获取 包括 二 维 码 的 各 种 类 型 的 格 
式 码 中 所 包含 的 文本 信息 ,保存 在 一 个 StringBuilder 对 象 中 。 以 上 正 是 通过 ZBar 开源 库 
解析 二 维 码 的 实现 过 程 。 

程序 重 写 异步 任务 的 onPostExecute 方法 ,判断 所 解析 出 来 的 二 维 码 文本 ,根据 文本 内 
容 的 不 同 ,将 文本 内 容 放 和 人 Bundle 对 象 中 ,然后 跳 转 到 不 同 的 详情 页 面 中 。 这 部 分 与 解析 
系统 图 库 中 的 图 片 后 所 执行 的 跳 转 操作 相同 。 

读者 需要 结合 以 上 讲解 ,阅读 ScanFragment 类 的 源码 加 以 体会 ,并 在 其 他 需要 实现 二 
维 码 扫描 操作 中 对 以 上 的 代码 加 以 复 用 。 
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HistoryFragment 对 应 第 二 个 菜单 项 的 应 用 界面 。 该 页 面 主 要 用 于 查询 数据 库 中 的 历 
史记 录 ,并 拼接 在 各 自 的 Tab 标签 页 中 。 根 据 之 前 介绍 Android SQLite 数据 库 的 章节 ,我 
们 知道 ,为 了 操作 数据 库 的 每 一 行 数据 ,需要 为 数据 库 中 的 每 一 张 表 建立 对 应 的 实体 类 ,将 
数据 表 中 的 行 记 录 对 象 化 。 接 下 来 看 看 QR where 应 用 的 SQLite 数据 库 中 唯一 一 张 表 
history 所 对 应 的 实体 类 History 的 源码 ,以 了 解 该 表 的 结构 设计 。 


package net. takewin. qrwhere. entity; 
import java. io. Serializable; 


public class History implements Serializable { 
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private static final long serialVersionUID = 1L; 

public int id; // 主 键 ID 

public String createTime; // 行 记录 插入 时 间 

public String title; // 标 题 , 显示 在 历史 记录 列表 页 面 每 个 列表 项 

public String content1; “ // 二 维 码 中 的 文本 内 容 

public String content2; ”// 该 属性 对 应 表 中 的 字段 content2, 该 字段 暂时 不 存放 任何 内 容 (废弃 ) 
public String typel; // 类 型 ,代表 历史 记录 是 解析 二 维 码 图 片 或 是 用 户 输入 文本 后 生成 二 维 码 
public String type2; // 类 型 ,代表 历史 记录 中 所 保存 的 信息 是 四 大 类 型 之 一 或 者 其 他 


public History() ( 
) 


public History(String createTime, String title, String contentl, String content2, String 
typel, String type2) ( 
this.createTime = createTime; 
this.title - title; 
this.contentl = contentl; 
this.content2 - content2; 
this.typel - typel; 
this.type2 - type2; 
) 


public History(int id, String createTime, String title, String contentl, String content2, 

String typel, String type2) { 

this. id - id; 

this.createTime - createTime; 

this.title - title; 

this.contentl - contentl; 

this.content2 - content2; 

this.typel = typel; 

this.type2 = type2; 


代码 文件 : codesV 11M 1. 2NQR where\cn\edu\hstc\qrwhere\entity\History. java 


以 上 类 定义 了 表 history 所 对 应 的 实体 类 。 对 typel 属性 需要 进一步 说 明 , 该 属性 对 应 
表 中 的 typel 字段 , 它 的 值 只 有 两 个 : 要 么 是 scan, 要 么 是 generate。 如 果 值 为 scan, 就 代表 
这 条 记录 中 的 content 字段 保存 的 是 解析 二 维 码 图 片 后 所 得 到 的 字符 串 文本 。 如 果 用 户 
单 击 应 用 底部 菜单 中 的 第 三 个 菜单 按钮 ,然后 单 击 页 面 四 个 按钮 中 的 任意 一 个 , 则 跳 转 到 对 
应 的 文本 信息 输入 页 面 ,输入 对 应 的 文本 内 容 , 然 后 单 击 生 成 按钮 生成 二 维 码 图 片 ,此 时 会 
将 这 些 文本 信息 有 规律 地 拼接 在 一 起 组 成 一 串 新 的 字符 串 ,然后 保存 到 数据 表 中 的 
contentl 字段 ,那么 此 时 这 条 数据 行 中 的 typel 字段 保存 为 generate。 

对 实体 类 中 的 type2 属性 也 需要 作 进 一 步 说 明 。 该 属性 对 应 表 中 的 type2 字段 , 它 的 
值 为 “url”*contact”location”wifi”else” 中 的 任意 一 个 。 前 面 四 个 代表 用 户 生 成 二 维 码 的 
类 型 ,例如 ,如 果 type2 属性 的 值 为 “location”, 则 代表 该 条 记录 是 用 户 单 击 第 三 个 菜单 项 所 
对 应 的 界面 中 的 第 三 个 按钮 后 ,在 高 德 地 图 中 定位 了 一 个 地 址 后 单 击 生 成 按钮 所 保存 的 记 
录 , 该 条 记录 中 的 content. 字段 所 保存 的 信息 是 地 理 位 置 的 经 纬度 信息 。 只 有 当 记录 是 由 
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应 用 解析 二 维 码 图 片 后 所 保存 的 记录 时 ,该 条 记录 的 type2 字段 的 值 才 有 可 能 为 "else”。 在 
这 种 情况 下 ,代表 应 用 所 解析 的 二 维 码 图 片 中 所 包含 的 文本 信息 不 属于 四 大 类 型 中 的 任何 
一 种 ,所 以 归 为 其 他 类 型 。 

通过 阅读 以 上 History 类 的 源码 以 及 所 附加 的 简单 说 明 ,相信 读者 此 时 已 经 对 数据 表 
的 结构 以 及 各 个 字段 的 含义 有 所 了 解 。 在 HistoryFragment 中 ,将 会 分 成 Scan 以 及 
Generate 两 个 Tab 标签 页 。 程 序 将 查询 应 用 的 history 表 中 的 数据 ,然后 根据 数据 的 typel 
的 值 , 将 该 条 数据 “ 归 类 ?到 对 应 的 Tab 标签 页 下 显示 。 

每 个 Tab 页 的 内 容 为 一 行 一 行 的 列表 项 拼接 而 成 的 列表 。 每 个 列表 项 分 为 左 . 中 、 右 
三 个 部 分 。 根 据 查询 出 来 的 数据 的 type2 字段 中 所 保存 的 值 ,将 会 在 “ 左 ” 部 分 显示 对 应 的 
图 标 , 例 如 ,如 果 该 列表 项 的 数据 为 联系 人 信息 ,该 列表 项 的 “ 左 " 部 分 将 显示 图 标 习 。“ 中 ” 
部 分 则 显示 数据 的 title 字段 所 保存 的 值 ,“ 右 ”部 分 则 为 固定 的 图 标 交 。 

下 面 的 XML 代码 为 HistoryFragment 所 对 应 的 界面 布局 源码 : 


< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 
android:background = "(à color/white" 
android:orientation = "vertical" » 


<! -- 顶部 标题 --> 
< RelativeLayout 
android:layout width= "fill parent" 
android:layout height = "wrap content" 
android:background = "(2 color/backhost" 
android:padding = "10dip" > 


< TextView 
android:id- "(9 + id/titleTextView" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout centerHorizontal = "true" 
android:layout centerVertical - "true" 
android:paddingTop - "10dp" 
android:paddingBottom - "10dp" 
android:text = "(Qstring/history" 
android:textColor = "(Qcolor/white" 
android:textSize = "20sp" /> 
«/RelativeLayout > 


< LinearLayout 
android:layout width = "fill parent" 
android:layout height = "fill parent" > 


< TabHost. 
android:id- "(2 + id/tabHost" 
android:layout width- "fill parent" 
android:layout height- "fill parent" > 
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« RelativeLayout 
android:layout width- "fill parent" 
android:layout height = "fill parent" > 


< Tablidget 
android: id = "(Zandroid:id/tabs" 
android:layout_width = "fill_parent" 
android:layout height = "wrap content" 
android:tabStripEnabled = "false" /> 


< FrameLayout 
android: id = "@android: id/tabcontent" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout below = "(Qandroid:id/tabs" > 


< ScrollView 
android:layout width- "fill parent" 
android:layout height - "wrap content" » 


< LinearLayout 
android:id- "(9 + id/tabl" 
android:layout width- "fill parent" 
android:layout height - "wrap content" 
vertical" » 





android:orientation = 
«/LinearLayout > 
«/ScrollView» 


< ScrollView 
android:layout width- "fill parent" 
android:layout height = "wrap content" > 


< LinearLayout 
android:id- "(9 + id/tab2" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:orientation- "vertical" > 

«/LinearLayout > 

«/ScrollView» 
«/FrameLayout > 
«/RelativeLayout > 
«/TabHost » 
«/LinearLayout > 


«/LinearLayout > 
代码 文件 : codes\11\QR whereVresMlayoutVactivity history. xml 
上 面 布局 在 TabHost 元 素 下 的 FrameLayout 元 素 下 放置 了 两 个 ScrollView ,代表 了 界 
面 中 的 两 个 Tab 标签 页 的 内 容 。 在 这 两 个 ScrollView 中 都 包含 了 一 个 LinearLayout 布 
局 ,在 HistoryFragment 中 会 将 查询 出 来 的 一 条 一 条 的 数据 显示 在 一 个 动态 创建 的 View 
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组 件 中 ,然后 将 创建 的 View 添加 到 LinearLayout 布局 中 。 
下 面 给 出 HistoryFragment 的 实现 源码 供 读者 阅读 体会 : 


package net. takewin. qrwhere. fragment; 


import java.util.ArrayList; 


import java.util.List; 


import net. 
import net. 
import net. 
import net. 
import net. 
import net. 
import net. 
import net. 
import net. 


takewin. 
takewin. 
takewin. 
takewin. 


takewin 
takewin 
takewin 


qrwhere. 
qrwhere. 
qrwhere. 
qrwhere. 
. qrwhere. 
. qrwhere. 
. qrwhere. 
takewin. 
takewin. 
import android. 
import android. 
import android. 
import android. 
import android. 
import android. 


qrwhere. 
qrwhere. 


view. View; 


R; 
activity.ContactDetailActivity; 
activity.ElseDetailActivity; 
activity.MainActivity; 
activity.MapResultActivity; 
activity.ScanResultActivity; 
activity.WifiResultActivity; 
entity.History; 
util.CommonUtil; 


content. Intent; 
database. Cursor; 
os. Bundle; 
support. v4. app. Fragment; 
view. LayoutInflater; 


import android. view. ViewGroup; 


import android. widget. 
import android. widget. 
import android. widget. 
import android. widget. 
import android. widget. 
import android. widget. 
import android. widget. 
import android. widget. 


ImageView; 

LinearLayout; 

LinearLayout. LayoutParams; 
RelativeLayout; 

TabHost; 

TabHost. OnTabChangeListener; 
TabHost. TabSpec; 

TextView; 


public class HistoryFragnment extends Fragment { 
private TabHost tabHost; 


(QOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle 
savedInstanceState) { 


return inflater. inflate(R.layout.activity history, null); 


(QOverride 

public void onActivityCreated(Bundle savedInstanceState) ( 
super. onActivityCreated(savedInstanceState); 
initTabHost(); 
initScanLinear(); 
initGenerateLinear(); 
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/ xx 


* 初始 化 TabHost 


*/ 


private void initTabHost() { 
tabHost = (TabHost) getActivity().findViewById(R. id. tabHost) ; 
tabHost. setup() ; 


[sx 


// 新 建 Tab 页 ,显示 经 过 第 一 个 菜单 项 ， 

// 对 二 维 码 图 片 进行 解析 后 所 保存 的 历史 记录 
TabSpec specl = tabHost.newTabSpec("Scan"); 
specl.setIndicator("Scan"); 
specl.setContent(R. id. tabl); 


// 新 建 Tab 页 ,显示 经 过 第 三 个 菜单 项 ， 

// 所 有 所 保存 的 历史 记录 都 是 经 过 输入 文本 后 生成 二 维 码 的 
TabSpec spec2 = tabHost.newTabSpec("Generate"); 

spec2. setIndicator("Generate"); 

spec2. setContent(R. id. tab2) ; 


tabHost. addTab( spec1) ; 

tabHost. addTab( spec2) ; 

updateTab(tabHost) ; 

tabHost. setOnTabChangedListener(new OnTabChangeListener() ( 


(QOverride 
public void onTabChanged(String tabId) ( 
updateTab(tabHost) ; 


* 控制 TabHost 的 标签 样式 
* @param tabHost 


*/ 


private void updateTab( final TabHost tabHost) { 
for (int i = 0; i< tabHost. getTabWidget().getChildCount(); i++) ( 


tabHost.getTabWidget().getChildAt(i).getLayoutParams().height = 80; 
View view = tabHost.getTabWidget().getChildAt(i); 
TextView tv = (TextView) tabHost. getTabWidget ( ). getChildAt (i). findViewById 


(android. R. id. title); 


tv.setTextSize(20); 

RelativeLayout.LayoutParams params = (Relativelayout.LayoutParams) tv. 
getLayoutParams(); 

params.addRule(RelativeLayout. ALIGN PARENT BOTTOM, 0); // 取 消 文字 底 边 对 齐 
params.addRule(RelativeLayout. ENTER IN PARENT, RelativeLayout. TRUE); 


//tv. setTypeface(Typeface. SERIF, 2); // 设 置 字体 和 风格 
if (tabHost.getCurrentTab() == i) ( // 选 中 
view. setBackgroundDrawable(getResources().getDrawable(R. drawable. 
segmented selected bg)); // 选 中 后 的 背景 


tv. setTextColor(this. getResources( ) . getColorStateList(R. color. backhost)); 
} else { // 不 选中 
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view. setBackgroundDrawable(getResources().getDrawable(R. drawable. 
segnented bg)); // 非 选择 的 背景 
tv. setTextColor (this. getResources ( ). getColorStateList (android. R. color. 
white)); 


/ xx 
* Scan 类 型 的 历史 记录 
*/ 
private void initScanLinear() { 
final LinearLayout objScanLinear = (LinearLayout) getActivity(). findViewById(R. id. 
tabl); 
// 拼 接 列表 


initTabLinear(objScanLinear, "scan"); 


/ xx 
* Generate 类 型 的 历史 记录 
*/ 
private void initGenerateLinear() { 
final LinearLayout objScanLinear = (LinearLayout) getActivity().findViewById(R. id. 
tab2); 
// 拼 接 列表 
initTabLinear(objScanLinear, "generate"); 


/** 
* 查询 数据 库 , 以 创建 时 间 为 分 类 , 拼接 列表 
*/ 
private void initTabLinear(final LinearLayout objScanLinear, String type) { 

String[] typeRaw = {type}; 

List < String> listCreateTime = getTime(typeRaw); 

for (String createTime : listCreateTime) { 
final List < History> temp = new ArrayList < History>(); 
String[] types = new String[2]; 
types[0] = type; 
types[1] = createTime; 
final List < History> listHistories = handleDB(types); 
final TextView objTitleText = new TextView(getActivity()); 
objTitleText. setLayoutParams(new LayoutParams(LayoutParams.MATCH PARENT, 
LayoutParams.WRAP CONTENT)); 
objTitleText. setBackgroundColor(R. color. backtext); 
objTitleText.setPadding(25, 5, 0, 5); 
objTitleText.setTextColor(R. color. white); 
objTitleText.setText(createTime); 
objScanLinear. addView(objTitleText); 
for (int i-0;i«listHistories.size();i**) ( 

final int item - i; 
View view = LayoutInflater. from(getActivity()). inflate(R. layout. listview 
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item, null); 
RelativeLayout objRelative = (RelativeLayout) view. findViewById (R. id. 
linearLayout item scan); 
ImageView objLeftImage = (ImageView) view. findViewById(R. id. imageView item - 
icon left scan); 
TextView objText = (TextView) view. findViewById(R. id. textView item name 
scan); 
if (listHistories.get(i).type2.equals("url")) ( 
objLeftImage. setImageResource(R. drawable. link); 
} else if (listHistories.get(i).type2.equals("contact")) ( 
objLeftImage. setImageResource(R. drawable.business card); 
] else if (listHistories.get(i).type2.equals("location")) { 
objLeftImage. setImageResource(R. drawable.map pin); 
} else if (listHistories. get( i). type2. equals(" wifi") && listHistories. get 
(i).title.contains("wifi:")) { 
objLeftImage. setImageResource(R. drawable. wifi); 
) else if (listHistories.get(i). type2. equals("wifi") && listHistories. get 
(i).title.contains("WIFI:")) { 
objLeftlImage. setImageResource(R. drawable.wifi 2); 
) else if (listHistories.get(i).type2. equals("calendar")) { 
objLeftlImage. setImageResource(R. drawable. text); 
) else if (listHistories.get(i).type2.equals("else")) ( 
objLeftlImage. setImageResource(R. drawable. text); 
} 
objText. setText(listHistories.get(i).title); 
objRelative. setOnClickListener(new View. OnClickListener() { 
@Override 
public void onClick(View v) { 
initItemOnClick(listHistories, item); 


}); 
objRelative. setOnLongClickListener(new View. OnLongClickListener() { 
@Override 
public boolean onLongClick(View v) { 
int theld = listHistories.get(item). id; 
MainActivity.dbManager. delete(thelId); 
//listHistories.remove(item); 
temp. add(listHistories.get(item)); 
objScanLinear. removeView(v); 
if (listHistories.size() == temp.size()) ( 
objScanLinear. removeView(objTitleText); 
temp. clear( ); 
listHistories.clear(); 
) 
return true; 


n; 
objScanLinear. addView(objRelative); 
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/ xx 
* 根据 文本 字符 串 判断 出 类 型 , 单 击 列表 项 跳 转 到 不 同 页 面 
*/ 
private void initItemOnClick(List «History» listHistories, int item) ( 
Intent intent - null; 
History history = listHistories.get(item); 
if (CommonUtil. isURL(history.contentl)) ( // 若 是 URL 
intent = new Intent(HistoryFragment. this. getActivity( ), ScanResultActivity. 


class); 


Bundle bundle = new Bundle(); 
bundle. putString("class", "HistoryFragnent"); 
bundle. putSerializable("history", history); 
intent. putExtras(bundle); 
) else if (history.contentl.contains("BEGIN:VCARD")) { // 若 是 联系 人 
String contentl = history.contentl; 
String[] contentis = content1. split("\r\n"); 
if (contentls.length» 1) { 
) eise ( 
contentis = contentl.split(" in"); 
) 
String nameStr - "", phoneStr - 


, emailStr - "", companyStr - "", titleStr - 


"", addressStr = "", websiteStr = ""; 


for (String content : contentis) ( 

if (content.contains("FN:")) ( 
String[] name = content. split(":"); 
nameStr = name[1]; 

) 

if (content.contains("TEL:")) ( 
String[] phone = content. split(":"); 
phoneStr = phone[1]; 

) 

if (content.contains("EMAIL:")) ( 
String[] email = content.split(":"); 
emailStr = email[1]; 

) 

if (content.contains("ORG:")) ( 
String[] company = content. split(":"); 
companyStr = company[1]; 

) 

if (content.contains("TITLE:")) ( 
String[] title = content. split(":"); 
titleStr - title[1]; 

) 

if (content.contains("ADR:")) ( 
String[] address = content. split(":"); 
addressStr - address[1]; 

) 

if (content. contains("URL:")) { 
String[] website = content. split(":"); 
websiteStr - website[1]; 
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class); 


class); 


class); 


[ux 


) 
intent = new Intent(HistoryFragnent.this.getActivity(), ContactDetailActivity. 


intent.putExtra("all", ""); 
intent.putExtra("name", nameStr); 
intent.putExtra("phone", phoneStr); 
intent.putExtra("email", emailStr); 
intent.putExtra("company", companyStr); 
intent.putExtra("title", titleStr); 
intent.putExtra("address", addressStr); 
intent.putExtra("website", websiteStr); 
intent.putExtra("contentl", history.contentl); 


) else if (history.contentl.contains("geo")) { // 若 是 经 纬度 


intent = new Intent(getActivity(), MapResultActivity.class); 

String[] locations = history.contentl.split(":"); 

locations = locations[1].split(","); 

intent. putExtra("lat", locations[0]); 

locations = locations[1].split("[?]"); 

intent. putExtra( "lon", locations[0]); 

if (locations!- null && locations. length» 1) ( 
locations = locations[1].split(" ="); 
intent.putExtra("q", locations[1]); 

) 

intent. putExtra( "title", history. title); 

intent. putExtra("content1", history.contentl); 

intent. putExtra("flag", "history" ); 


} else if (history.contentl.contains("WIFI:")) { // 若 是 WIFI 


intent = new Intent (HistoryFragment. this. getActivity(), WifiResultActivity. 


Bundle bundle = new Bundle(); 

bundle. putString( "class", "HistoryFragment"); 
bundle. putSerializable("history", history); 
intent. putExtras(bundle); 


) else ( // 其 他 


) 


intent = new Intent(HistoryFragnent. this. getActivity(), ElseDetailActivity. 


Bundle bundle = new Bundle(); 

bundle. putString("class", "history"); 
bundle. putString( "else", history.contentl); 
intent. putExtras( bundle); 


startActivity( intent); 


* 操作 数据 库 , 查 询 表 中 所 有 不 重复 的 时 间 字 段 


*/ 


private List < String» getTime(String[] typeRaw) ( 


List < String» listCreateTime = new ArrayList «String»(); 
Cursor cursor = MainActivity.dbManager. queryTheCreateTime(typeRaw) ; 
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getActivity(). startManagingCursor(cursor); 
while(cursor. moveToNext()) { 
String createTime = cursor.getString(0); 
listCreateTime. add(createTime); 
} 


return listCreateTime; 


} 


/ xx 
* 操作 数据 库 , 查询 表 
*/ 
Private List <History> handleDB(String[ ] typeRaw) { 
List<History> listHistories = new ArrayList <History>(); 
Cursor cursor = null; 
if (typeRaw[0].equals("scan")) { 
cursor = MainActivity. dbManager. queryTheScan(typeRaw); 
) else if (typeRaw[0]. equals("generate")) ( 
cursor = MainActivity.dbManager. queryTheGenerate( typeRaw) ; 
) 
gethctivity().startManagingCursor(cursor); // 托 付 给 activity 根据 自己 的 生命 周期 去 
管理 Cursor 的 生命 周期 
while(cursor.moveToNext()) { 
int id = cursor.getInt(0); 
String createTime - cursor.getString(1); 
String title = cursor.getString(2); 
String contentl - cursor.getString(3); 
String content2 - cursor.getString(4); 
String typel = cursor.getString(5); 
String type2 = cursor.getString(6); 
History history = newHistory( id, createTime, title, contentl, content2, typel, 
type2); 
listHistories. add(history); 
) 


return listHistories; 


代码 文件 : codes\11\QR where\cn\edu\hstc\qrwhere\fragment\HistoryFragment. java 


在 上 面 的 程序 中 ,在 拼接 列表 时 ,程序 调用 自 定义 方法 getTimeCString[ ] typeRaw) ,该 
方法 调用 MainActivity. dbManager 的 query TheCreateTime (String[ ] type) 方 法 并 根据 
typel 字段 查询 出 该 类 型 下 所 有 数据 的 createTime 字段 ,该 字段 对 应 数据 的 插入 时 间 , 即 创 
建 时 间 。 经 过 queryTheCreateTime 的 查询 SQL 语句 中 的 “group by” 关 键 字 ,过 滤 掉 重复 
的 时 间 字 段 的 数据 , 剩 下 不 重复 的 。 这 部 分 内 容 所 对 应 的 知识 属于 Android SQLite 部 分 的 
知识 ,此 处 不 再 袭 述 ,读者 可 以 阅读 该 部 分 的 章节 进行 巩固 。 

程序 查询 出 不 重复 的 时 间 字 段 后 , 放 入 一 个 List 数组 中 ,然后 在 拼接 列表 项 的 方法 
initTabLinear(final LinearLayout objScanLinear. String type) 中 遍历 该 数组 ,每 遍历 出 一 
个 时 间 字 段 的 值 , 则 动态 创建 一 个 TextView。 在 该 TextView 中 显示 了 该 时 间 字 段 的 值 ， 
然后 根据 该 时 间 字 段 以 及 typel 字段 查询 出 历史 记录 数据 ,存放 在 数组 中 ,然后 遍历 该 数 
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组 ,根据 数据 中 type2 的 值 以 及 title 值 , 拼 接 出 对 应 的 列表 项 。 这 样 ,经 过 双重 的 循环 遍历 ， 
则 可 以 将 相同 时 间 的 数据 集中 在 一 起 。 

程序 中 还 为 每 个 列表 项 添加 了 单 击 事件 监听 器 以 及 长 按 事件 监听 器 。 单 击 事件 监听 器 
实现 了 单 击 列表 项 跳 转 到 对 应 的 详情 页 面 中 ,这 部 分 与 ScanFragment 中 扫描 二 维 码 后 的 
跳 转 类 似 , 不 同 之 处 在 于 在 每 个 跳 转 时 Bundle 或 Intent 所 带 的 数据 中 会 加 入 不 同 的 标识 字 
段 数据 ,比如 , 跳 转 到 联系 人 信息 详情 页 面 时 ,如 果 是 从 ScanFragment 页 面 跳 转 的 , 则 会 在 
Intent 中 带 入 “all” 数 据 , 该 数据 不 为 空 ; 而 如 果 是 从 HistoryFragment 页 面 跳 转 的 , 则 
Intent 中 所 带 该 数据 为 空 。 这 样 ,在 详情 页 面 中 获取 该 数据 ,如 果 不 为 空 , 则 表示 不 是 从 历 
史记 录 页 面 中 跳 转 过 来 的 ,那么 就 需要 将 该 数据 插入 历史 表 中 ; 如 果 为 空 , 则 代表 不 再 需要 
将 数据 插入 历史 表 中 。 长 按 事件 监听 器 则 实现 长 按 列表 项 删除 历史 表 中 对 应 的 行 记 录 以 及 
将 该 列表 项 从 列表 页 中 删除 。 

读者 应 仔细 阅读 HistoryFragment 类 的 源码 ,结合 以 上 的 功能 分 解 ,加 深 体会 。 


(1.5 开发 第 三 个 菜单 项 所 对 应 的 界面 GeneratorFragment 


第 三 个 菜单 项 所 对 应 的 界面 布局 比较 简单 ,从 上 而 下 放置 四 个 按钮 供用 户 单 击 跳 转 到 
对 应 类 型 的 文本 编辑 页 面 ,包括 URL Contact, Location, WiFi 四 个 类 型 。 下 面 将 界面 布局 
的 代码 贴 出 : 


< LinearLayout xmlns:android = "http://schemas.android. com/apk/res/android" 
android:layout width- "match parent" 
android:layout height = "match parent" 
android:background = "(2 drawable/back generator" 
android:orientation = "vertical" » 


<! -- 顶部 标题 --- 


< RelativeLayout 
android:layout_width = "fill parent" 
android:layout height = "wrap content" 
android:background = "(2 color/backhost" 
android:padding = "10dip" > 


< TextView 

android:id- "(9 + id/titleTextView" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout centerHorizontal = "true" 
android:layout centerVertical - "true" 
android:paddingTop = "10dp" 
android:paddingBottom = "10dp" 
android:text = "@ string/generator" 
android: textColor = "(ücolor/white" 
android: textSize = "20sp" /> 

</RelativeLayout > 
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< TableLayout 
android:layout width- "fill parent" 
android:layout height- "fill parent" 
android:stretchColumns = "0,3" > 


< TableRow 
android:id- "(à + id/row shortURL" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout weight = "1" > 


< TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android: src = "(Qdrawable/website icon" /> 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android: paddingLeft = "20dp" 
android:text = "QR / Short URL" 
android:textColor = "(3color/white" 
android:textSize = "20sp" /> 


« TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" /> 
«/TableRow > 


< TableRow 
android:layout width- "fill parent" 
android:layout height = "wrap content" > 


< TextView 
android:layout width- "fill parent" 
android:layout height = "0.5dp" 








android:layout span = "4" 

android: background = "(Zcolor/gainsboro" /> 
</TableRow > 
< TableRow 


android:id="@ + id/row contact" 
android:layout_width = "fill_parent" 
android:layout height = "wrap content" 
android:layout weight = "1" > 
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< TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" /> 


< InageView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity "center vertical" 
android: src = "(Qdrawable/contact icon" /> 


< TextView 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android:paddingLeft - "20dp" 
android:text - "Contact" 
android:textColor = "(Qcolor/white" 
android:textSize = "20sp" /> 


< TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" /> 
</TableRow > 


< TableRow 
android:layout width- "fill parent" 
android:layout height = "wrap content" > 


< TextView 
android:layout width- "fill parent" 
android:layout height = "0. 5dp" 
android:layout span- "4" 
android: background = "(2 color/gainsboro" /> 
«/TableRow > 


< TableRow 
android:id- "(à + id/row location" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout weight = "1" > 


< TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" /> 





layout width- "wrap content" 
id:layout height - "wrap content" 

android:layout gravity = "center vertical" 

android: src = "(Qdrawable/location icon" /> 
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< TextView 
android:layout width= "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android:paddingLeft = "20dp" 
android:text = "Location" 
android:textColor = "(3color/white" 
android: textSize = "20sp" /> 


< TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" /» 
«/TableRow » 


« TableRow 
android:layout width- "fill parent" 
android:layout height = "wrap content" > 


« TextView 
android:layout width- "fill parent" 
android:layout height = "0. 5dp" 
android:layout span = "4" 
android: background = "(Zcolor/gainsboro" /> 
</TableRow > 


< TableRow 
android: id ="@ + id/row_wifi" 
android:layout_width = "fill_parent" 
android:layout height = "wrap content" 
android:layout weight = "1" > 


< TextView 
android:layout width- "fill parent" 
android:layout height - "wrap content" /» 


< ImageView 
android:layout width- "wrap content" 
id:layout height - "wrap content" 
id:layout gravity = "center vertical" 
id:src = "(Qdrawable/wifi icon" /> 


id: layout_width= "wrap content" 

layout height = "wrap content" 
id:layout gravity = "center vertical" 

android:paddingLeft = "20dp" 

text = "Wifi" 

id:textColor = "(2color/white" 

id:textSize = "20sp" /> 
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< TextView 
android:layout width- "fill parent" 
android:layout height = "wrap content" /> 
«/TableRow > 
«/TableLayout > 


«/LinearLayout > 
代码 文件 : codes\11\QR whereVresMlayoutVactivity generator. xml 

注意 ,上 面 的 布局 使 用 了 TableLayout 布局 ,每 一 种 类 型 占据 一 个 TableRow, 这 样 可 
以 在 该 布局 所 对 应 的 Java 程序 中 为 整个 TableRow 添加 单 击 事件 监听 器 ,保证 用 户 单 击 一 
行 中 的 任意 位 置 都 可 以 触发 跳 转 页 面 事件 ,而 无 须 对 准 图 标 或 者 图 标 右边 的 文字 单 击 。 

GeneratorFragment 界面 的 每 个 TableRow 都 添加 了 单 击 事件 监听 器 ,而 该 单 击 事件 监 
听 器 只 是 实现 页 面 的 跳 转 ,也 就 是 从 当前 页 面 MainActivity 跳 转 到 对 应 类 型 的 生成 二 维 码 
的 页 面 。 因 此 ,GeneratorFragment 只 需要 重 写 onCreateView 加 载 对 应 的 布局 文件 ,然后 
TE onActivityCreated 方法 中 为 各 个 TableRow 添加 单 击 事件 监听 器 。GeneratorFragment 
界面 的 Java 程序 如 下 : 





package net. takewin. qrwhere. fragment; 


import net. takewin. qrwhere. R; 

import net. takewin. qrwhere. activity. GenerateContactActivity; 
import net. takewin. qrwhere. activity. GenerateLocationActivity; 
import net. takewin. qrwhere. activity. GenerateURLActivity; 
import net. takewin. qrwhere. activity. GenerateWifiActivity; 
import android. content. Intent; 

import android. os. Bundle; 

import android. support. v4. app. Fragnent; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget. TableRow; 


public class GeneratorFragment extends Fragment { 
private TableRow shortURLRow, contactRow, locationRow, wifiRow; 


(QOverride 
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle 
savedInstanceState) { 
return inflater. inflate(R.layout.activity generator, null); 
) 


(QOverride 

public void onActivityCreated(Bundle savedInstanceState) ( 
super. onActivityCreated(savedInstanceState); 
initShortURLRow(); 
initContactRow(); 
initLocationRow(); 
initWifiRow(); 
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private void initShortURLRow() { 
ShortURLRow = (TableRow) getActivity().findViewById(R. id. row shortURL); 
ShortURLRow. setOnClickListener(new View.OnClickListener() { 
(QOverride 
public void onClick(View v) { 
Intent intent = new Intent(getActivity(), GenerateURLActivity.class); 
startActivity(intent); 


np; 


private void initContactRow() { 
contactRow = (TableRow) getActivity().findViewById(R. id. row contact); 
contactRow. setOnClickListener(new View.OnClickListener() ( 
(QOverride 
public void onClick(View v) { 
Intent intent = new Intent(getActivity(), GenerateContactActivity.class); 
startActivity(intent); 


n; 


private void initLocationRow() ( 
locationRow = (TableRow) getActivity().findViewById(R. id. row location); 
locationRow. setOnClickListener(new View.OnClickListener() ( 
(QOverride 
public void onClick(View v) ( 
Intent intent = new Intent(getActivity(), GenerateLocationActivity.class); 
startActivity(intent); 


n; 


private void initWifiRow() { 
wifiRow = (TableRow) getActivity().findViewById(R. id.row wifi); 
wifiRow.setOnClickListener(new View.OnClickListener() ( 
(2 Override 
public void onClick(View v) { 
Intent intent - new Intent(getActivity(), GenerateWifiActivity.class); 
startActivity(intent); 


n; 


代码 文件 : codes\11\QR whereVenVedu Viste NarwhereM£ragnentVGeneratorFragment. java 


11.5.1. 开发 URL 编辑 页 面 GenerateURLActivity 


当 用 户 单 击 GeneratorFragment 界面 中 的 第 一 个 TableRow 时 ,将 跳 转 到 编辑 URL 地 
址 的 页 面 , 即 GenerateURLActivity。 该 页 面 布 局 十 分 简单 ,左上 角 放 置 了 一 个 返回 按钮 供 
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用 户 单 击 结束 该 页 面 ; 在 返回 按钮 的 右边 放置 了 一 个 TextView 组 件 用 于 显示 页 面 标题 
“OR / Short URL"; 在 页 面 标题 的 正 下 方 放 置 了 一 个 ImageView 组 件 , 该 组 件 加 载 了 一 张 
事先 设计 好 的 png 格式 的 图 片 ,整个 ImageView 作为 一 个 生成 二 维 码 的 按钮 供用 户 单 击 跳 
转 到 另 一 个 页 面 ,根据 输入 的 URL. 地 址 生成 二 维 码 图 片 并 显示 出 来 。 在 生成 按钮 的 下 方 
放置 了 一 个 EditText 输入 框 供用 户 编 辑 URL 地 址 。 该 界面 所 对 应 的 XML 布局 源码 比较 
简单 ,在 此 不 作 粘 贴 展示 ,读者 可 以 通过 本 书 附带 源码 获得 。 下 面 给 出 实现 该 布局 的 Java 
程序 , 即 GenerateURLActivity. java。 


package net. takewin. qrwhere. activity; 


import net. takewin. qrwhere. R; 

import net. takewin. qrwhere. util. CommonUtil; 

import net. takewin. qrwhere. view. MyGenerateUrlDialog; 
import android. app. Activity; 

import android. app. Dialog; 

import android. content. Context; 

import android. content. Intent; 

import android. os. Bundle; 

import android. text. Editable; 

import android. text. TextWatcher; 

import android. view. Gravity; 

import android. view. View; 

import android. view. ViewTreeObserver. OnGlobalLayoutListener; 
import android. view. inputmethod. InputMethodManager; 
import android. widget. EditText; 

import android. widget. ImageView; 


public class GenerateURLActivity extends Activity { 
private ImageView backToGenerator, generateUrllmageView; 
private EditText longURLEdt; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity generate url); 


initLongURLEdt() ; 
initBackToGenerator(); 
initGenerateUrlBtn(); 
) 
/ xx 


* 为 页 面 左 上 角 的 返回 按钮 添加 单 击 事件 监听 器 

* 实现 当 单 击 返回 按钮 时 ,检查 软 键盘 是 否 弹出 ， 

* 如 果 弹 出 则 先 隐藏 软 键盘 ,然后 再 结束 页 面 ， 

* 防止 因为 没有 先 将 弹出 的 键盘 隐藏 而 导致 的 整个 页 面 的 震动 

*/ 

private void initBackToGenerator() { 

backToGenerator = (ImageView) findViewById(R. id.back to generator); 
backToGenerator. setOnClickListener(new View. OnClickListener() ( 
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GOverride 
public void onClick(View v) ( 
InputMethodManager imm = (InputMethodManager) getSystemService (Context. 
INPUT METHOD SERVICE); 
boolean isO0pen = imm. isActive(); 
if (isOpen) { 
imm. hideSoftInputFromWindow(longURLEdt.getWindowToken(), 0); 
} 
GenerateURLActivity.this.finish(); 


) 
/** 
* 为 页 面 中 的 生成 按钮 添加 单 击 事件 监听 器 
*/ 
Private void initGenerateUrlBtn() { 
// 加 载 布局 中 的 生成 按钮 
generateUrlImageView = (ImageView) findViewById(R. id. imageview url btn); 
// 为 生成 按钮 添加 事件 监听 器 
generateUrlImageView. setOnClickListener (new View. OnClickListener() { 
@Override 
public void onClick(View v) { 
if (CommonUtil. isURL(longURLEdt. getText().toString())) { 
/ [URL 的 正则 表达 式 验 证 
String contentStr = longURLEdt.getText().toString(); 
// 跳 转 到 生成 的 二 维 码 显示 页 面 
Intent intent = new Intent(GenerateURLActivity. this, UrlImageActivity. 
class); 


Bundle bundle = new Bundle(); 
bundle. putString("contentStr", contentStr); 
intent. putExtras(bundle); 
startActivity(intent); 
)else( — // Zi A REB XE URL 的 正则 表达 式 验 证 
// 弹 出 一 个 自 定义 对 话 框 提示 not valid url( 不 是 有 效 的 URL 地 址 ) 
Dialog dialog = new MyGenerateUrlDialog(GenerateURLActivity. this, R. 
style.MyScanDialog); 
dialog. show(); 


"m 
* 实现 当 URL 编辑 框 获得 焦点 的 时 候 ( 软 键盘 出 现 ), 显示 光标 ， 
* 当 编 辑 框 失去 焦点 时 ( 软 键盘 消失 ) ,隐藏 编 辑 框 光标 
*/ 
private void initLongURLEdt() { 
longURLEdt - (EditText) findViewById(R. id.edt long url); 
final View activityRootView = findViewById(R. id. linear); 
activityRootView. getViewTreeObserver ( ). addOnGlobalLayoutListener ( new 
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OnGlobalLayoutListener() { 
private int preHeight = 0; 
@Override 
public void onGlobalLayout() { 
int heightDiff = activityRootView.getRootView().getHeight() — 
activityRootView.getHeight(); 
// 在 数据 相同 时 ,减少 发 送 重复 消息 。 因 为 实际 上 在 输入 法 出 现时 会 多 次 调用 这 
个 onGlobalLayout 方法 。 
if (preHeight == heightDiff) { 
return; 
} 
preHeight = heightDiff; 
if (heightDiff > 100) ( 
longURLEdt. setCursorVisible(true); 
) else ( 
longURLEdt. setCursorVisible(false); 
} 
} 
Di 


// 为 URL 输入 框 添加 编辑 框 监听 器 ,实现 自动 切换 居中 和 居 左 显示 
longURLEdt. addTextChangedListener(textWatcher); 
) 


/xx 
* 监听 编辑 框 里 输入 内 容 的 变化 
* 实现 当 URL 的 输入 框 中 有 输入 了 内 容 的 时 候 , 则 将 内 容 居中 显示 , 
* 当 输入 框 中 没有 任何 内 容 但 输入 框 有 获得 焦点 时 , 则 将 光标 居 左 显示 
*/ 
private TextWatcher textWatcher = new TextWatcher() { 
(QOverride 
public void onTextChanged(CharSequence s, int start, int before, int count) ( 
) 


@Override 
public void beforeTextChanged(CharSequence s, int start, int count, int after) { 
} 


@Override 
public void afterTextChanged(Editable s) { 
if (longURLEdt. getText().toString().trim() == null || longURLEdt. getText(). 


toString().trim().length() == 0) { 
longURLEdt. setGravity(Gravity. CENTER VERTICAL); 
} else { 
longURLEdt. setGravity(Gravity. CENTER) ; 
} 


F 


代码 文件 : codes\11\QR where\cn\edu\hstc\qrwhere\activity\GenerateURLActivity. java 
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上 面 的 程序 中 有 几 个 需要 注意 的 方法 : 

(D 方法 initBackToGenerator() 用 于 为 返回 按钮 添加 事件 监听 器 ,该 事件 监听 器 实现 在 
结束 自身 Activity 之 前 ,检测 页 面 中 的 软 键盘 是 否 是 弹出 状态 ,如 果 是 , 则 将 其 隐藏 。 这 样 
做 的 好 处 是 ,防止 页 面 结 束 后 ,因为 页 面 中 的 软 键盘 是 弹出 状态 而 造成 上 级 页 面 的 震动 。 读 
者 可 以 注释 掉 隐 藏 软 键盘 的 代码 段 ,然后 单 击 返 回 按钮 ,对 比 下 效果 。 需 要 强调 的 是 ,在 
QR where 的 所 有 页 面 中 ,只 要 页 面 含有 EditText 编辑 框 , 则 在 将 该 页 面 结 束 之 前 ,都 会 使 
用 该 段 代码 检测 软 键盘 并 做 处 理 。 读 者 也 可 以 将 该 段 代码 复 用 在 其 他 应 用 中 。 

© 方法 initLongURLEdt 实现 当 URL 编辑 框 获 得 焦点 的 时 候 ( 软 键盘 出 现 ) ,显示 光 
标 ; 当 编 辑 框 失去 焦点 时 ( 软 键盘 消失 ) ,隐藏 编辑 框 光标 。 该 方法 也 可 以 复 用 在 有 这 个 需 
求 的 应 用 中 。 

C 程序 中 为 URL 输入 框 添加 了 编辑 框 监听 器 TextWatcher。 该 监听 器 实现 当 URL 
的 输入 框 中 有 输入 了 内 容 的 时 候 , 则 将 内 容 居中 显示 , 当 输 入 框 中 没有 任何 内 容 但 输入 框 获 
得 了 焦点 时 , 则 将 光标 居 左 显示 。TextWatcher 能 监听 编辑 框 中 的 内 容 变 化 ,读者 可 以 在 一 
些 特殊 的 需求 中 使 用 它 。 


11.5.2 开发 根据 URL 地 址 生成 二 维 码 图 片 的 页 面 UrllmageActivity 


在 页 面 GenerateURLActivity 中 ,用 户 输入 了 一 串 URL 地 址 , 若 通 过 URL 的 正则 表 
达 式 验证 , 则 用 户 单 击 生 成 按钮 时 ,会 跳 转 到 生成 二 维 码 图 片 的 页 面 UrlImageActivity ,并 
通过 Bundle 对 象 将 GenerateURLActivity 页 面 中 的 URL 地 址 传递 到 UrlImageActivity 页 
面 中 。 在 UrlImageActivity 页 面 中 ,程序 将 获得 从 GenerateURLActivity 页 面 传 过 来 的 数 
据 , 根 据 数 据 生成 二 维 码 图 片 并 显示 在 页 面 中 。 

UrlImageActivity 页 面 的 布局 比较 简单 ,在 页 面 左 上 角 放 置 一 个 返回 按钮 供用 户 单 击 
结束 自身 Activity,' 页 面 右 上 角 放 置 了 一 个 按钮 供用 户 单 击 后 在 页 面 底部 弹出 更 多 按钮 ,在 
这 两 个 按钮 的 中 间 放 置 了 一 个 TextView 组 件 ,用 于 显示 根据 长 链接 (网 址 ) 转 换 成 的 短 链 
接 , 即 页 面 标题 ,在 标题 的 正 下 方 放置 了 一 个 ImageView 用 以 显示 所 生成 的 二 维 码 图 片 ,在 
ImageView 的 下 方 放置 了 一 个 TextView 用 于 显示 短 链 接 。 由 于 界面 布局 不 复杂 ,在 此 不 
作 展 示 。 接 下 来 ,直接 实现 布局 所 对 应 的 Java 程序 , 即 UrlImageActivity 类 的 源码 ,如 下 
所 示 : 


package net. takewin. qrwhere. activity; 


import java. io.File; 
import java. util. ArrayList; 


import net. takewin. qrwhere. R; 

import net. takewin. qrwhere. encoding. EncodingHandler; 
import net. takewin. qrwhere. entity. History; 

import net. takewin. qrwhere. util. CommonUtil; 

import net. takewin. qrwhere. util. Constant; 

import net. takewin. qrwhere. util. HttpUtil; 

import net. takewin. qrwhere. util. ShareHelper; 

import android. app. Activity; 
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import android. app. AlertDialog; 

import android. content.DialogInterface; 
import android. content.DialogInterface. OnCancelListener; 
import android. content. Intent; 

import android. graphics. Bitmap; 

import android. os. AsyncTask; 

import android. os. Bundle; 

import android. view. Gravity; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. widget. ImageView; 

import android. widget. TextView; 


import com. google. zxing. WriterException; 


public class UrllImageActivity extends Activity { 
private ImageView backImg, uploadImg; 
private TextView titleTxt, textTxt; 
private Bitmap qrCodeBitmap; 
private ImageView urlImageView; 
private String contentStr; 
private AlertDialog prompt; 
private AsyncTask < String, Integer, String> access; 
private String fileName - ""; 
private SelectUploadTypePopupWindow menuWindow; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity url image); 
initWidget(); 


private void initWidget() ( 
// 加 载 页 面 标题 的 Text View 
titleTxt = (TextView) findViewById(R. id.textview title url image); 
// 加 载 二 维 码 图 片 下 方 显 示 URL 短 链 接 的 TextView 
textTxt = (TextView) findViewById(R. id.textview text url image); 
initBack(); 
initShare(); 
initUrlImageView(); 


/ xx 
* 实现 返回 按钮 
*/ 
Private void initBack() { 
backImg = (ImageView) findViewById(R. id.back to generator i); 
backImg. setOnClickListener(new View. OnClickListener() ( 
(QOverride 
public void onClick(View v) { 
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if (!fileName. equals("")) { // 当 用 户 单 击 过 发 送 Email 的 按钮 时 ,fileName 不 为 空 
File file = new File(fileName); 
CommonUtil. deleteFile(file. getParent()); 
// 删 除 发 送 邮 件 时 所 保存 到 SDCard 的 二 维 码 图 片 
file = null; 
fileName = ""; 
} 
UrlImageActivity.this.finish(); 


np; 


/** 
* 右上 角 的 按钮 事件 , 单 击 后 将 会 在 底部 弹出 更 多 按钮 
* 1.Mail( 发 送 邮件 ) 
* 2.Save to Album( 保 存 至 图 库 ) 
* 3.Share to( 分 享 至 ( 微 博 、facebook 等 )) 
* 4.Cancel( 取 消 ) 
*/ 
private void initShare() { 
uploadImg - (ImageView) findViewById(R. id. action); 
uploadImg. setOnClickListener(new View.OnClickListener() ( 
(2 Override 
public void onClick(View v) ( 
// 实 例 化 SelectPicPopupWindow 
menuWindow = new SelectUploadTypePopupWindow(UrlImageActivity. this, 
itemsOnClick); 
// 显 示 窗 口 设置 layout 在 PopupWindow 中 显示 的 位 置 
menuWindow. showAtLocation(UrllmageActivity. this. findViewById(R. id. linear | 
image), Gravity. BOTTOM | Gravity.CENTER HORIZONTAL, 0, 0); 
) 
Di 
) 


/ xx 
* 获取 Bundle 中 所 带 的 数据 (文本 字符 串 ), 生 成 二 维 码 图 片 
*/ 
private void initUrlImageView() { 
urlImageView = (ImageView) findViewById(R. id.iv qr image); 
Intent intent 7 getIntent(); 
Bundle bundle = intent.getExtras(); 
contentStr - bundle.getString("contentStr"); 
// 根 据 字 符 串 生成 二 维 码 图 片 并 显示 在 界面 上 ,第 二 个 参数 为 图 片 的 大 小 (350* 350) 
try { 
//ZXing 生成 二 维 码 图 片 
qrCodeBitmap = EncodingHandler.createQRCode(contentStr, 450); 
// 将 生成 的 二 维 码 图 片 显示 在 页 面 ImageView 组 件 
urlImageView. setImageBitmap(qrCodeBitmap); 
) catch (WriterException e) { 
e. printStackTrace(); 
} 
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// 调 用 异步 任务 
acquire(); 


} 


/*x 
* 异步 任务 ,访问 地 址 ,将 长 链接 转换 成 短 链接 ,操作 数据 库 
*/ 
private void acquire() { 
access = new AsyncTask < String, Integer, String»() ( 
(QOverride 
protected void onPreExecute() { 
super. onPreExecute( ) ; 
// 对 话 框 
prompt = HttpUtil.prompt(UrlImageActivity.this, "Loading..."); 
prompt. setOnCancelListener(new OnCancelListener() ( 
@Override 
public void onCancel(DialogInterface arg0) { 
access. cancel(true); 
} 
}); 
} 


@Override 
protected String doInBackground(String... arg0) { 
String result = null; 
try { 
// 使 用 HTTP GET 方式 ,传人 长 链接 (网 址 ), 返 回 对 应 的 短 链接 
result = HttpUtil.getDataByGet(contentStr); 
} catch (Exception e) { 
e. printStackTrace(); 
) 
return result; 


) 


(QOverride 
protected void onPostExecute(String result) ( 
try { 
if (result ! null) { 
titleTxt.setText(result); // 将 短 链接 显示 在 页 面 顶部 Text View 标题 
textTxt. setText(result); // 将 短 链接 显示 在 二 维 码 图 片 的 下 方 
handleDB(); // 插 入 数据 
) 
) catch (Exception e) ( 
System. out. println(e. getMessage()) ; 
) 
prompt.dismiss(); // 取 消 对 话 框 
} 
}; 


access. execute( ); 
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/ xx 
* 操作 数据 库 , 将 数据 插入 history X 
x*/ 
private void handleDB() { 
ArrayList «History» histories = new ArrayList «History»(); 
String createTime = CommonUtil.getTime(); // 获 取 当 前 时 间 
History history = new History(createTime, titleTxt.getText().toString(), 
contentStr, "", "generate", "url"); 
histories. add(history); 
MainActivity.dbManager. add(histories); 
) 


/ xx 
* 底部 弹出 按钮 事件 监听 器 
*/ 
private OnClickListener itemsOnClick = new OnClickListener() ( 
public void onClick(View v) { 

// 单 击 选择 框 外 任意 位 置 ,底部 弹出 按钮 消失 

menuWindow. dismiss(); 

switch (v.getId()) ( 

case R. id. buttonl: 
// 调 用 sendEnail 方法 发 送 邮件 
fileName = CommonUtil.sendEmail(UrlImageActivity.this, urllImageView, 
titleTxt. getText(). toString()); 
break; 

case R. id. button2: 
// 调 用 saveToA1bun 方法 将 二 维 码 图 片 保存 到 系统 图 库 中 
CommonUtil. saveToAlbum(UrllmageActivity.this, urllImageView); 
break; 

case R. id. button3: 
// 调 用 第 三 方 库 ShareSDK 分 享 至 微 博 、facebook 等 平台 
String share = "链接 地 址 : ”+ contentStr + "." + Constant. SHAREFROM; 
String imagePathStr = CommonUtil. savelmage(urlImageView); 
ShareHelper shareHelper = new ShareHelper(UrllImageActivity.this, 
contentStr, share, imagePathStr, Constant. SHAREURL); 
ShareHelper. showShare() ; 
break; 

case R. id. btn cancel: 
// 取 消 弹出 按钮 
menuWindow.dismiss(); 

default: 
break; 


H 


代码 文件 : codes\11\QR where\cn\edu\hstc\qrwhere\activity\UrlImageActivity. java 


上 面 的 程序 中 有 几 个 地 方 需 要 讲解 一 下 : 
(D 方法 initUrlImageView 实现 获取 上 级 页 面 传 过 来 的 Bundle 数据 , 即 URL FEE. 
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然后 调用 工具 类 EncodingHandler 的 createQRCode( String str. int widthAndHeight) 方 
法 ,传人 URL 字符 串 以 及 所 要 生成 的 图 片 宽 高 ,返回 对 应 的 二 维 码 图 片 的 Bitmap 对 象 。 
在 方法 createQRCode 中 ,生成 二 维 码 使 用 的 是 ZXing 工具 。 因 此 ,EncodingHandler 工具 
类 是 一 个 可 以 复 用 的 工具 类 ,读者 可 以 在 任意 需要 生成 二 维 码 图 片 的 项 目 中 调用 该 工具 类 ， 
方便 地 实现 功能 。 

O 单 击 页 面 右上 角 , 会 在 底部 弹出 更 多 按钮 ,这 些 按 钮 自 上 而 下 排列 。 其 实 , 这 些 排列 
好 的 按钮 ,整体 上 是 一 个 事先 自 定义 好 的 PopupWindow。 新 建 一 个 继承 Ñ android. 
widget. PopupWindow 的 类 SelectUploadTypePopupWindow ,在 该 自 定义 类 中 加 载 对 应 的 
布局 ,其 实 , 用 户 希 望 在 底部 弹出 多 少 个 按钮 以 及 每 个 按钮 对 应 的 样式 ,都 可 以 通过 布局 任 
意 实 现 , 本 应 用 则 是 在 一 个 LinearLayout 布局 中 自 上 而 下 放置 四 个 Button 按钮 并 为 各 个 按 
钮 定义 好 相关 样式 和 属性 。 在 类 SelectUploadTypePopupWindow 中 ,程序 只 需 加 载 布 局 中 各 
个 按钮 并 为 其 添加 单 击 事件 监听 器 即 可 。 此 处 采用 的 是 以 构造 函数 参数 的 形式 传人 事件 监听 
器 对 象 , 也 就 是 上 面 程序 中 的 itemsOnClick 对 象 。 至 于 SelectUploadTypePopupWindow 类 的 
实现 ,可 以 通过 本 书 附 带 源 码 获 得 ,并 在 其 他 项 目 中 加 以 模仿 利用 。 在 需要 调 出 
SelectUploadTypePopupWindow 类 所 定义 的 整个 选择 框 的 程序 中 ,只 需要 创建 出 
SelectUploadTypePopupWindow 对 象 ,并 调用 其 showAtLocation 方法 即 可 。 读 者 可 以 阅 
读 上 面 程序 中 右上 角 按 钮 事件 的 方法 initShar() 加 以 体会 。 

© 上 面 程序 所 实现 的 底部 弹出 按钮 的 事件 监听 器 中 ,为 弹出 的 选择 框 中 的 第 一 个 按钮 
绑 定 了 单 击 事件 ,调用 工具 类 CommonUtil 中 的 sendEmail ) 方 法 实现 发 送 Email。 实 际 
上 ,sendEmail( ) 方 法 调用 的 正 是 普通 的 Android API 来 实现 邮件 的 发 送 的 。 由 于 需要 将 二 
维 码 图 片 作为 邮件 的 附件 发 送 ,根据 API 方法 .程序 需要 在 为 邮件 添加 附件 的 代码 实现 之 
前 ,将 页 面 中 的 二 维 码 保存 为 图 片 文件 ,存放 在 SDCard 中 。 因 此 ,sendEmail() 方 法 中 调用 
了 savelmage 方法 保存 图 片 并 返回 文件 路 径 。 这 也 造成 了 用 户 单 击发 送 邮 件 的 按钮 后 ,不 
管用 户 是 否 发 送 了 该 封 邮 件 , 都 会 在 SDCard 中 保存 了 页 面 中 所 生成 的 二 维 码 图 片 , 造 成 了 
空间 浪费 ,这 就 需要 在 页 面 销毁 的 时 候 , 将 该 文件 删除 。 因 此 ,在 实现 返回 按钮 时 ,程序 会 判 
断 是 否 有 保存 的 文件 ,有 则 删除 。 

@ 底部 弹 框 中 的 第 二 个 按钮 实现 了 将 二 维 码 图 片 保存 至 系统 图 库 的 功能 。 上 面 程序 
中 调用 的 是 CommonUtil 工具 类 中 的 saveToAlbum 方法 来 完成 该 功能 。 实 际 上 ,该 方法 也 
是 调用 普通 的 Android API 来 实现 的 。 读 者 可 以 通过 本 书 附带 源码 获得 其 源码 ,对 该 方法 
进行 复 有 用。 事实 上 ,整个 CommonUtil 工具 类 都 是 一 些 通用 的 实现 ,希望 读者 可 以 好 好 
利用 。 

© 底部 弹 框 中 的 第 三 个 按钮 实现 对 应 用 的 一 键 分 享 。 单 击 该 按钮 ,将 会 弹出 一 个 选择 
框 ,在 该 选择 框 中 显示 了 各 大 主流 社交 平台 的 图 标 , 单 击 任意 图 标 ,实现 快速 将 应 用 以 及 附 
带 的 其 他 文本 信息 分 享 至 对 应 平台 。 例 如 , 单 击 新 浪 微 博 的 图 标 , 将 会 弹出 一 个 窗 体 生成 一 
条 微 博 , 微 博 的 内 容 为 程序 自动 生成 ,该 微 博 附带 了 URL 地 址 的 二 维 码 图 片 ,用 户 可 以 对 
该 微 博 进行 二 次 编辑 ,然后 单 击 分 享 按钮 ,调用 微 博 客户 端 或 者 网 页 版 微 博 获 取 授 权 登 录 后 
发 出 该 条 微 博 。 该 按钮 所 实现 的 功能 需要 借助 Android ShareSDK ,这 是 我 们 极力 推荐 的 一 
个 第 三 方 产品 。ShareSDK 是 为 IOS、Android 的 App 提供 社会 化 功能 的 一 个 组 件 , 开 发 者 
仅 需 10 分 钟 即 可 集成 到 自己 的 App 中 , 它 不 仅 支持 国内 外 40 多 家 的 主流 社交 平台 ,帮助 
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开发 者 轻松 实现 社会 化 分 享 、 登 录 、 关 注 、 获 得 用 户 资料 获取 好 友 列 表 等 主流 的 社会 化 功 
能 ,还 有 强大 的 社会 化 统计 分 析 管理 后 台 , 可 以 实时 了 解 用 户 、 信 息 流 、 回 流 率 、 传 播 效率 等 
数据 ,有 效 地 指导 移动 App 的 日 常 运营 与 推广 ,同时 为 App 引入 更 多 的 社会 化 流量 。 在 其 
官方 网 站 http://www. mob. com/ 上 可 下 载 相 关 SDK, 在 网 站 文档 中 心中 可 以 进入 
Android 集成 文档 的 介绍 页 面 , 该 页 面 详细 介绍 了 如 何 获取 ShareSDK 的 AppKey、 如 何 将 
下 载 的 SDK 快速 集成 到 我 们 的 项 目 中 ,一 些 必要 的 配置 以 及 如 何 调用 分 享 代码 。 通 过 文档 
中 心 的 学 习 , 可 快速 实现 应 用 分 享 至 各 大 主流 社交 平台 的 功能 。 建 议 读者 去 官网 获取 最 新 
的 API. 

© 阅读 上 面 的 程序 ,可 以 发 现 程序 通过 自 定义 工具 类 ShareHelper 的 showShare() 方 
法 实现 了 一 键 分 享 功能 。 程 序 在 创建 ShareHelper 对 象 时 通过 其 构造 方法 传人 了 必要 的 文 
本 内 容 、 链 接地 址 .图片 (二 维 码 图 片 ) 地 址 等 参数 。showShare( ) 方 法 正 是 实现 分 享 的 关键 
代码 ,实际 上 ,这 部 分 代码 在 ShareSDK 的 官网 文档 中 心中 会 有 介绍 ,读者 学 习 后 对 其 加 以 
修改 ,可 形成 自己 的 自 定义 方法 。 读 者 可 以 通过 阅读 本 书 附带 源码 ,加 深 该 部 分 实现 的 体 
会 。 希 望 读者 能 够 好 好 学 习 ShareSDK 的 知识 ,开发 出 更 好 的 分 享 模块 功能 。 


11.5.3 开发 坐标 拾取 页 面 GenerateLocationActivity 


上 面 两 个 小 节 介 绍 了 底部 第 三 个 菜单 项 对 应 的 界面 中 的 第 一 个 按钮 , 单 击 其 会 跳 转 到 
URL 编辑 页 面 ,输入 正确 的 URL 地 址 后 , 单 击 生成 按钮 , 跳 转 到 二 维 码 生 成 页 面 ,并 在 页 
面 中 人 处理 将 二 维 码 图 片 通过 邮件 发 送出 去 ,保存 到 系统 图 库 一 键 分 享 至 社交 平台 等 功能 。 

界面 中 的 第 二 个 按钮 所 对 应 的 功能 则 是 跳 转 到 联系 人 信息 编辑 页 面 ,页 面 右上 角 提 供 了 
一 个 按钮 供用 户 访 问 手机 联系 人 应 用 ,获取 任意 联系 人 数据 ,然后 返回 信息 编辑 页 面 ,自动 将 
该 联系 人 的 信息 填充 至 页 面 对 应 的 编辑 框 中 。 这 部 分 的 实现 则 是 通过 ContentResolver 访问 
手机 联系 人 应 用 的 ContentProvider 所 暴露 的 数据 ,这 与 9. 3 节 的 内 容 相 对 应 ,在 此 不 多 作 
讲解 ,读者 可 以 通过 本 书 附带 源码 学 习 联 系 人 信息 编辑 页 面 的 代码 。 

同样 ,在 页 面 中 放置 了 一 个 生成 二 维 码 的 按钮 , 单 击 该 按钮 则 跳 转 到 对 应 的 二 维 码 生成 
页 面 。 在 页 面 中 根据 上 级 页 面 所 传递 过 来 的 联系 人 信息 ,调用 通用 的 方法 生成 二 维 码 图 片 。 
所 有 显示 二 维 码 图 片 的 页 面 的 功能 大 体 相 同 , 实 现 源码 也 大 同 小 异 。 因 此 , 对 于 
GeneratorFragment 界面 中 的 第 二 个 按钮 生成 联系 人 信息 二 维 码 则 不 多 作 介绍 ,相信 读者 
通过 阅读 附带 项 目 源码 ,配合 源码 中 的 注释 ,可 以 很 好 地 理解 其 实现 过 程 。 

接 下 来 ,需要 重点 介绍 的 是 GeneratorFragment 界面 中 第 三 个 按钮 所 对 应 的 功能 实现 。 
单 击 界面 中 的 第 三 个 TableRow, 跳 转 到 坐标 拾取 页 面 GenerateLocatinActivity 中 。 该 页 
面 顶 部 中 间 放 置 了 一 个 TextView 组 件 用 于 显示 经 纬度 信息 ,在 其 下 方 放置 了 一 个 生成 按 
钮 供用 户 单 击 跳 转 到 生成 二 维 码 图 片 的 页 面 , 在 生成 按钮 的 下 方 则 提供 了 高 德 地 图 组 件 ,在 
页 面 底部 从 左 至 右 放置 了 一 个 搜索 按钮 以 及 一 个 带 有 自动 提示 功能 的 编辑 框 
AutoCompleteTextView 组 件 。 下 面 一 起 来 看 看 GenerateLocatinActivity 所 对 应 的 界面 布 
局 的 实现 源码 : 

<?xml version = "1.0" encoding = "utf — 8"?> 


< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android:id- "@ + id/linear contact" 
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android:layout width- "match parent" 
android:layout height = "match parent" 
android: background = "(Zdrawable/back hong" 
android:orientation = "vertical" > 


<! -- 顶部 标题 --> 

< RelativeLayout 
android:layout width= "fill parent" 
android:layout height = "wrap content" 
android:background = "(à color/backhost" 
android:padding = "10dp" > 


< InageView 
android:id- "(à + id/location back to generator" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout alignParentLeft = "true" 
android:layout centerVertical = "true" 
android: src = "(Zdrawable/navbar back" /> 


< TextView 

android:id- "(d + id/textview title generate location" 
android:layout width- "wrap content" 
android:layout height = "wrap content" 
android:layout centerHorizontal = "true" 
android:layout centerVertical = "true" 
android:paddingBottom = "10dp" 
android: paddingTop = "10dp" 
android: text = "Location:" 
android: textColor = "@color/white" 
android: textSize = "18sp" /> 

</RelativeLayout > 


< TextView 
android:layout_width = "fill_parent" 
id:layout height = "0. 5dp" 
android:background = "@color/gray" /> 





android: id="@ + id/imageview location btn" 
id:layout_width = "fill_parent" 
id:layout height = "wrap content" 

adjustViewBounds - "true" 

id:src = "(Qdrawable/location btn" /> 





< RelativeLayout 
android:layout width= "fill parent" 
android:layout height = "fill parent" 
android:background = "(d color/white" > 


< LinearLayout 
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android:id- "@ + id/linear auto" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout alignParentBottom = "true" 
android:orientation - "horizontal" 
android:paddingBottom = "20dp" > 


« ImageView 
android:id- "(8 + id/searchButton" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout gravity = "center vertical" 
android:paddingLeft = "15dp" 
android: src = "(Qdrawable/search icon" /> 


< hutoCompleteTextView 
android: id = "@ + id/keyWord" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:layout marginLeft = "15dp" 
android: background = "(2 null" 
android:completionThreshold = "1" 
android:dropDownVerticalOffset = "1.0dip" 
android:hint = "Search..." 
android: imeOptions = "actionSearch" 
android: inputType = "text|textAutoComplete" 
android:maxLength = "20" 
android:popupBackground = "(4 color/black" 
android:singleLine = "true" 
android:textColor = " # 000000" 
android:textSize = "18.0sp" /> 


«/LinearLayout > 


< com. amap. api. maps2d. MapView 
android:id- "@ + id/map" 
android:layout width- "fill parent" 
android:layout height - "fill parent" 
android:layout above = "(did/linear auto" 
android:paddingBottom = "5dp" /> 
«/RelativeLayout > 


«/LinearLayout > 
代码 文件 : codes\11\QR whereVresMayoutVactivity generate location.xml 
上 面 的 XML 代码 实现 了 坐标 拾取 页 面 的 样式 布局 ,为 界面 中 的 AutoCompleteTextView 
组 件 添加 了 android:imeOptions 王 "actionSearch" 的 属性 以 及 对 应 值 , 实 现 当 用 户 单 击 底部 
的 输入 框 时 弹出 的 软 键盘 带 有 搜索 按钮 。 读 者 还 需要 认识 的 是 com. amap. api. maps2d. 
MapView 这 个 组 件 ,该 组 件 需要 读者 在 高 德 地 图 开放 平台 http://lbs. amap. com/ 上 下 载 
了 相关 SDK ,并 将 Jar WERE QR where 中 后 ,然后 才 可 使 用 。 
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读者 需要 访问 高 德 地 图 开放 平台 http://lbs. amap. com/ ,然后 免费 注册 开发 者 用 户 ， 
单 击 导航 栏 中 * 开 发 "下 的 子 级 导航 “Android 地 图 SDK” 和 “Android 定位 SDK”, 在 这 两 个 
导航 页 面 中 下 载 相关 的 Jar 包 。 

由 于 QR where 需要 使 用 到 高 德 地 图 及 其 定位 功能 ,所 以 需要 在 开放 平台 中 下 载 2D 地 
图 显示 包 AMap_2DMap_V2. x. x. jar, AMap_Services_V2. x. x. jar 以 及 定位 包 AMap_ 
Location V2. x. x. jar。 将 下 载 好 的 三 个 Jar 包 复 制 到 QR where 项 目 目 录 中 的 libs 文件 夹 
下 , 即 可 在 布局 页 面 中 使 用 com. amap. api. maps2d. MapView 组 件 ,程序 在 页 面 中 即 可 使 用 
该 组 件 加 载 高 德 地 图 。 

在 开放 平台 的 下 载 区 中 ,除了 相关 的 Jar 下 载 链 接 之 外 ,还 提供 了 相关 的 Demo 示例 以 
及 文档 手册 的 下 载 。 读 者 可 以 将 相关 的 Demo 示例 下 载 到 本 地 计算 机 中 ,然后 将 示例 程序 
添加 到 Eclipse 开发 工具 中 , 即 可 获得 其 源码 程序 。 再 根据 示例 程序 中 的 功能 模块 的 实现 ， 
复制 这 部 分 的 代码 到 QR where 中 加 以 修改 即 可 。 例 如 需要 创建 一 个 基本 2D 地 图 ,那么 可 
以 将 2D 地 图 示例 工程 的 项 目 源 码 Import 到 Eclipse 中 ,然后 打开 创建 基本 2D 地 图 的 
Activity, 将 创建 地 图 的 源码 复制 到 自己 的 应 用 中 并 加 以 修改 。 

根据 以 上 介绍 的 方法 , 摘 取 示例 程序 中 的 相关 模块 的 实现 代码 ,集成 到 本 应 用 的 坐标 拾 
取 页 面 GenerateLocationActivity 中 并 加 以 修改 。 最 终 GenerateLocationActivity 源码 实现 
如 下 所 示 : 


package net. takewin. qrwhere. activity; 


import java. util. ArrayList; 
import java. util. List; 


import net. takewin. qrwhere. R; 

import net. takewin. qrwhere. util. AMapUtil; 
import android. app. Activity; 

import android. app. ProgressDialog; 

import android. content. Intent; 

import android. location. Location; 

import android. os. Bundle; 

import android. text. Editable; 

import android. text. TextWatcher; 

import android. view. KeyEvent; 

import android. view. View; 

import android. view. View. OnClickListener; 
import android. view. inputmethod. EditorInfo; 
import android. widget. ArrayAdapter; 

import android. widget. AutoCompleteTextView; 
import android. widget. ImageView; 

import android. widget. TextView; 

import android. widget. TextView. OnEditorActionListener; 
import android. widget. Toast; 


import com. amap. api. location. AMapLocation; 
import com. amap. api. location. AMapLocationListener; 
import com. amap. api. location. LocationManagerProxy; 


import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 
import com. 


amap. 


amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 
amap. 


api. 
.api. 
.api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
api. 
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location. LocationProviderProxy; 

maps2d. AMap; 

maps2d. AMap. InfoWindowAdapter; 

maps2d. CaneraUpdateFactory; 

maps2d. LocationSource; 

maps2d. MapView; 

maps2d. model. BitmapDescriptorFactory; 
maps2d. model. Marker; 

maps2d. model. MyLocationStyle; 

maps2d. overlay.PoiOverlay; 

services. core. AMapException; 
services.core.Poiltem; 

services. core. SuggestionCity; 

services. help. Inputtips; 

services. help. Inputtips. InputtipsListener; 
services. help. Tip; 

services. poisearch. PoiltemDetail; 

services. poisearch. PoiResult; 

services. poisearch. PoiSearch; 

services. poisearch. PoiSearch. OnPoiSearchListener; 


public class GenerateLocationActivity extends Activity implements  InfoWindowAdapter, 
TextWatcher, OnPoiSearchListener, OnClickListener, LocationSource, AMapLocationListener { 


private MapView mapView; // 地 图 显示 组 件 

private AMap aMap; // 地 图 实例 

private AutoCompleteTextView searchText; // 输 入 搜索 关键 字 

private String keyWord - ""; // 存 放 输 入 的 poi 搜索 关键 字 
private ProgressDialog progDialog = null; // 搜 索 时 进度 条 

private PoiResult poiResult; / [poi 返回 的 结果 

private PoiSearch. Query query; //poi 查询 条 件 类 

private PoiSearch poiSearch; //poi 搜索 

private ImageView back; // 返 回 按钮 


Private ImageView toLocationImage; 


// 跳 转 到 生成 二 维 码 图 片 页 面 的 生成 按钮 


private TextView titleLocation; 


private double lat, lon; 


// 页 面 顶部 标题 , 显示 经 纬度 信息 (Location: 纬 度 度数 ， 经 度 度数 ) 
// 存 放 纬度 度数 .经度 度数 


private OnLocationChangedListener mListener; // 监 听 搜索 后 变化 
private LocationManagerProxy mAMapLocationManager; 

private boolean flag - true; 

private String locationCity - ; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate( savedInstanceState); 
setContentView(R.layout. activity generate location); 


mapView 


"n 


(MapView) findViewById(R. id. map); // 加 载 地 图 显示 组 件 


mapView. onCreate(savedInstanceState); // 此 方法 必须 重 写 
titleLocation = (TextView) this.findViewById(R. id. textview title generate 
location); 


// 获 取 标题 Text View 
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initMap(); // 初 始 化 地 图 

initBack(); // 返 回 按钮 

initToLocationImage(); // 生 成 按钮 
@Override 


protected void onResume() ( 
super. onResume( ) ; 
mapView. onResume( ) ; 


(QOverride 

protected void onPause() { 
super. onPause( ) ; 
mapView. onPause() ; 
deactivate(); 


(QOverride 

protected void onSaveInstanceState(Bundle outState) ( 
super. onSaveInstanceState(outState); 
mapView. onSaveInstanceState(outState); 


(QOverride 

protected void onDestroy() ( 
super. onDestroy() ; 
mapView. onDestroy(); 


/xx 
* 初始 化 地 图 对 象 
*/ 
private void initMap() { 
if (aMap == null) { 
aMap = mapView.getMap(); 
) 
setUpMap() ; 


/ xx 
* 返回 按钮 监听 器 
*/ 
Private void initBack() { 
back = (ImageView) this.findViewById(R. id. location back to generator); 
back. setOnClickListener(new View.OnClickListener() { 
(2 Override 
public void onClick(View v) { 
GenerateLocationActivity.this.finish(); 


np; 
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/xx 
* 生成 按钮 监听 器 ,将 经 纬度 信息 按照 规则 拼接 成 字符 串 , 通 过 Bundle 对 象 传递 到 生成 二 维 
码 的 页 面 中 
*/ 
private void initToLocationImage() { 
toLocationImage = (ImageView) this.findViewById(R. id. imageview location btn); 
toLocationImage. setOnClickListener(new View.OnClickListener() { 
@Override 
public void onClick(View v) { 
Intent intent = new Intent(GenerateLocationActivity. this, 
LocationImageActivity. class); 
Bundle bundle = new Bundle(); 
bundle. putString("nameStr", "Geo:" + lat + "," + lon + "? 
getCameraPosition( ). zoom); 
bundle.putString("contentStr", "geo:" + lat + "," +lon + "?q=" + aMap. 
getCameraPosition(). zoom); 
intent. putExtras(bundle); 
startActivity(intent); 


" * aMap. 





/ xx 
* 设置 页 面 监 听 
*/ 
private void setUpMap() { 
if (flag) { 
// 自 定义 系统 定位 小 蓝 点 
MyLocationStyle myLocationStyle = new MyLocationStyle(); 
myLocationStyle. myLocationIcon(BitmapDescriptorFactory. fromResource(R. 
drawable.location marker)); // 设 置 小 蓝 点 的 图 标 
myLocationStyle. strokeColor(0); // 设 置 圆 形 的 边框 颜色 
myLocationStyle. radiusFillColor(0); 
nyLocationStyle. strokeWidth(0. 0f); // 设 置 圆 形 的 边框 粗细 
aMap. moveCamera(CameraUpdateFactory. zoomTo( 20) ) ; 
aMap. setMyLocationStyle(myLocationStyle); 


aMap. setLocationSource(this); // 设 置 定 位 监听 
aMap. getUiSettings().setMyLocationButtonEnabled(true); 
// 设 置 默 认定 位 按钮 是 否 显示 


aMap.setMyLocationEnabled(true); ”// 设 置 为 true 表示 显示 定位 层 并 可 触发 定位 ， 
false 表示 隐藏 定位 层 并 不 可 触发 定位 ,默认 
是 false 


ImageView searButton = (ImageView) findViewById(R. id. searchButton); 
searButton. setOnClickListener(this); 

searchText = (AutoCompleteTextView) findViewById(R. id. keyWord) ; 
searchText.addTextChangedListener(this); ”// 添 加 文本 输入 框 监听 事件 
searchText. setOnEditorActionListener(new OnEditorActionListener() { 
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GOverride 
public boolean onEditorAction(TextView v, int actionId, KeyEvent event) { 
if (actionId-- EditorInfo.IME ACTION SEARCH) ( 


searchButton(); 
} 
return true; 
} 
n; 
) 
[xx 
* 单 击 搜索 按钮 
*/ 


public void searchButton() ( 
keyWord = AMapUtil.checkEditText(searchText); 
if ("".equals(keyWord)) { 
Toast. makeText(GenerateLocationActivity.this, "请 输入 关键 字 "，3000). show( ); 
return; 
) eise ( 
doSearchQuery(""); 
) 
) 


/** 
* 开始 进行 poi 搜索 
*/ 
protected void doSearchQuery(String scope) { 
if (progDialog == null) { 
showProgressDialog(); // 显 示 进 度 框 
} 
// 第 一 个 参数 表示 搜索 字符 串 , 第 二 个 参数 表示 poi 搜索 类 型 ,第 三 个 参数 表示 poi 搜索 区 


域 ( 空 字符 串 代 表 全 国 ) 
query = new PoiSearch.Query(keyWord, "", scope); 
query. setPageSize(1); // 设 置 每 页 最 多 返回 多 少 条 poiitem 
query. setPageNun(0) ; // 设 置 查 第 一 页 


poiSearch = new PoiSearch(this, query); 
poiSearch. setOnPoiSearchListener(this); 
poiSearch. searchPOIAsyn(); 

) 


/ xx 
* 显示 进度 框 
*/ 
Private void showProgressDialog() { 
if (progDialog == null) 
progDialog = new ProgressDialog(this); 
progDialog. setProgressStyle(ProgressDialog. STYLE SPINNER); 
progDialog. setIndeterminate(false); 
progDialog. setCancelable(false); 
progDialog. setMessage(" IE TE 18 Æ : Vn" + keyWord); 
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progDialog. show( ); 


Jik 
* 隐藏 进度 框 
*/ 
private void dissmissProgressDialog() { 
if (progDialog != null) ( 
progDialog.dismiss(); 
progDialog = null; 
titleLocation. setText("Location:"); 


private String getSuggestCity(List < SuggestionCity» cities) ( 
for (int i=0; i«cities.size(); i++) { 
if (locationCity. equals(cities.get(i).getCityName())) ( 
return locationCity; 


) 
return cities.get(0).getCityName(); 


(QOverride 
public void onClick(View v) ( 
switch (v.getId()) ( 
/ xx 
* 单 击 搜索 按钮 
*/ 
case R. id. searchButton: 
searchButton(); 
break; 
default: 
break; 


@Override 
public void onPoiltemDetailSearched(PoiltemDetail arg0, int argl) { 


) 


@Override 
public void onPoiSearched(PoiResult result, int rCode) { 
if (rCode == O)( 


if (result != null && result.getQuery() != null) ( //18 4 poi 的 结果 
if (result.getQuery(). equals(query)) { // 是 否 是 同一 条 


poiResult = result; 
// 取 得 搜索 到 的 poiitems 有 多 少 页 
List < PoiItem> poiltems = poiResult.getPois(); 


// 取 得 第 一 页 的 poiitem 数据 ,页 数 从 数字 0 开始 
List < SuggestionCity> suggestionCities = poiResult. getSearchSuggestion- 
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Citys(); // 当 搜索 不 到 poiitem 数据 时 ,会 返回 含有 搜索 关键 字 的 城市 信息 
if (poiltems != null && poiltems.size() > 0) { 


dissmissProgressDialog(); // 隐 藏 对 话 框 
aMap. clear(); // 清 理 之 前 的 图 标 


aMap. moveCamera(CameraUpdateFactory. zoomTo(20) ) ; 
PoiOverlay poiOverlay - new PoiOverlay(aMap, poiltems); 
poiOverlay. removeFromMap(); 

poiOverlay. addToMap() ; 

poiOverlay. zoomToSpan( ) ; 


lat = poiltems.get(0).getLatLonPoint().getLatitude(); 

lon = poiltems.get(0).getLatLonPoint().getLongitude(); 
double lat = Math.round(lat * 1000) / 1000.0; 

double lon = Math.round(lon * 1000) / 1000.0; 
titleLocation.setText("Location:" + lat + "," + lon); 


} else if (suggestionCities != null && suggestionCities.size() > 0) ( 


doSearchQuery(getSuggestCity(suggestionCities)); 


} else ( 


dissmissProgressDialog(); // 隐 藏 对 话 框 
Toast. nakeText(GenerateLocationActivity.this, "对 不 起 ,没有 搜索 到 


相关 数据 !"，3000). show(); 


} 
) eise ( 


} 


Toast. makeText (GenerateLocationActivity. this, "对 不 起 , 没有 搜索 到 相关 数 


据 !"，3000). show(); 
} 


} else if (rCode == 27)( 
Toast. makeText (GenerateLocationActivity. this, "搜索 失败 , 请 检查 网 络 连 接 !"， 


3000). show() ; 


} else if (rCode == 32) ( 
Toast. makeText(GenerateLocationActivity.this, "key 验证 无 效 !"，3000). show() ; 


) eise ( 


Toast. makeText (GenerateLocationActivity. this, "未 知 错误 , 请 稍 后 重 试 ! 错误 码 


为 "，3000). show(); 
} 


@Override 


public void afterTextChanged(Editable s) ( 


) 


(QOverride 


public void beforeTextChanged(CharSequence s, int start, int count, int after) ( 


) 


(QOverride 


public void onTextChanged(CharSequence s, int start, int before, int count) { 
String newText = s.toString().trim(); 
Inputtips inputTips = new Inputtips(GenerateLocationActivity.this, 
new InputtipsListener() ( 
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@Override 
public void onGetInputtips(List <Tip> tipList, int rCode) ( 
if (rCode -- 0) ( // 正 确 返回 


List< String> listString = new ArrayList < String>(); 
for (int i = 0; i< tipList. size(); i++) { 
listString.add(tipList.get(i).getName()); 
) 
Arrayhdapter < String > aAdapter = new Arrayhdapter < String > 
(gethpplicationContext(), R.layout.route inputs, listString); 
searchText. setAdapter(aAdapter); 
ahdapter. notifyDataSetChanged(); 


ni 
try { 
inputTips. requestInputtips(newText, ""); 
// 第 一 个 参数 表示 提示 关键 字 , 第 二 个 参数 默认 代表 全 
) catch (AMapException e) { 
e. printStackTrace(); 





,也 可 以 为 城市 区 号 


(QOverride 
public View getInfoContents(Marker arg0) { 
return null; 


(QOverride 

public View getInfoWindow(Marker marker) ( 
View view = getLayoutInflater().inflate(R.layout.poikeywordsearch uri, null); 
TextView title = (TextView) view. findViewById(R. id. title); 
title.setText(marker. getTitle()); 
TextView snippet - (TextView) view.findViewById(R. id. snippet); 
snippet. setText(marker.getSnippet()); 
return view; 


@Override 
public void onLocationChanged(Location aLocation) { 
) 


@Override 
public void onProviderDisabled(String provider) { 
} 


@oOverride 
public void onProviderEnabled(String provider) { 
} 


@Override 
public void onStatusChanged(String provider, int status, Bundle extras) { 
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@Override 
public void onLocationChanged(AMapLocation aLocation) { 
if (mListener != null && aLocation != null) { 

locationCity = aLocation.getCity(); 
mListener. onLocationChanged(aLocation); // 显 示 系 统 小 蓝 点 
lat = aLocation.getLatitude(); 
lon = aLocation.getLongitude(); 
double lat = Math. round(lat * 1000) / 1000.0; 
double lon = Math.round(lon * 1000) / 1000.0; 
titleLocation.setText("Location:" + lat + ", "+ lon ); 
flag = false; 
deactivate(); 


(& SuppressWarnings("deprecation") 
(QOverride 
public void activate(OnLocationChangedListener listener) ( 
mListener - listener; 
if (mAMapLocationManager == null) ( 
mAMapLocationManager = LocationManagerProxy.getInstance(this); 
/x 
* mAMapLocManager. setGpsEnable( false); 
* 1.0.2 版 本 新 增 方法 ,设置 true 表示 混合 定位 中 包含 gps 定位 , false 表示 纯 网 络 
定位 ,默认 是 true Location 
* RPI 定 位 采用 GPS 和 网 络 混合 定位 方式 
* /第 一 个 参数 是 定位 provider, 第 二 个 参数 时 间 最 短 是 2000 毫秒 ,第 三 个 参数 距离 
间隔 单位 是 米 , 第 四 个 参数 是 定位 监听 者 
*/ 
mAMapLocationManager. requestLocationUpdates ( LocationProviderProxy. 
AMapNetwork, 3000, 10, this); 
} 


(& SuppressWarnings("deprecation") 
(QOverride 
public void deactivate() { 
mListener - null; 
if (mAMapLocationManager !- null) ( 
mAMapLocationManager. removeUpdates(this); 
mAMapLocationManager. destory(); 
) 
mAMapLocationManager = null; 


代码 文件 : codes\11\11.2\QR where\cn\edu\hstc\grwhere\activity\GenerateLocationActivity. java 


上 面 的 程序 中 有 几 个 地 方 需要 重点 介绍 : 


第 11 章 ”二 维 码 应 用 一 一 QR where 


CD 上 面 的 程序 实现 加 载 界面 布局 ,初始 化 地 图 ,为 自动 提示 组 件 AutoCompleteTextView 
添加 内 容 变化 监听 器 ,实现 自动 补 全 地 理 位 置信 息 功能 .并 以 下 拉 列 表 形 式 展示 。 即 通过 为 
AutoCompleteTextView 对 象 添 加 文本 输入 框 监听 器 , 重 写 onTextChanged 方法 ,在 该 方法 
中 调用 高 德 地 图 相关 API 实现 联想 查询 。 比 如 ,在 关键 字 输 入 框 中 输入 潮州 二 字 , 则 会 弹 
出 一 个 下 拉 列 表 ,显示 潮州 路 潮州 宾馆 、 潮 州 西湖 等 。 用 户 直接 选中 任意 一 个 则 可 直接 补 
全 关键 字 搜 索 框 。 这 部 分 实现 可 以 阅读 GenerateLocationActivity 类 的 onTextChanged 方 
法 进行 理解 。 在 以 后 的 实际 项 目 中 ,如 果 需 要 实现 高 德 地 图 的 关键 字 搜索 框 自 动 提示 功能 ， 
则 可 以 复 用 这 部 分 的 代码 。 

© 当 用 户 单 击 关 键 字 输入 框 左边 的 搜索 按钮 或 软 键盘 右 下 角 的 搜索 按钮 时 ,将 调用 
searchButton() 方 法 ,检查 输入 框 是 否 为 空 ,如 果 为 空 , 则 提示 用 户 ; 如 果 不 为 空 , 则 调用 
doSearchQuery 方法 开始 搜索 地 图 。 而 doSearchQuery 方法 正 是 调用 了 高 德 地 图 的 API 进 
行 poi 搜索 操作 。 这 部 分 的 代码 也 是 参照 官方 平台 所 提供 的 示例 程序 中 的 实现 代码 而 实现 
的 。 在 实际 项 目 开发 中 ,应 学 会 从 示例 程序 中 找到 自己 所 需要 的 代码 进行 复 用 。poi 搜索 
的 真正 操作 则 是 通过 重 写 方法 onPoiSearched 实现 的 。 该 重 写 方法 参照 示例 程序 ,添加 进 
QR where 所 需要 的 特殊 业务 逻辑 ,比如 ,获取 纬度 度数 以 及 经 度 度数 ,然后 显示 在 页 面 顶 
部 标题 TextView 中 。 如 以 下 代码 片段 所 示 : 

lat = poiltems.get(0).getLatLonPoint().getLatitude(); 

lon = poiltems.get(0).getLatLonPoint().getLongitude(); 

double lat = Math.round(lat * 1000) / 1000.0; 


double lon = Math.round(lon * 1000) / 1000.0; 
titleLocation.setText("Location:" + lat + "," + lon ); 


© 上 面 所 介绍 的 poi 搜索 的 方法 onPoiSearched 中 ,实现 了 在 地 图 中 添加 搜索 位 置 的 
标记 , 当 用 户 单 击 该 标记 , 则 在 该 标记 上 弹出 一 个 窗 体 以 显示 地 理 名 称 以 及 街道 信息 , 即 作 
为 标记 的 扩展 信息 。 这 部 分 的 功能 则 是 通过 重 写 getInfoWindow ( Marker marker) 方 法 实 
现 的 。 该 方法 加 载 了 标记 扩展 信息 的 显示 窗 体 的 自 定义 布局 文件 poikeywordsearch_uri. 
xml, 该 布局 从 上 而 下 放置 了 两 个 TextView 用 于 显示 地 理 名 称 以 及 街道 信息 。 通 过 
marker 对 象 的 getTitle() 方 法 获取 地 理 名 称 以 及 getSnippet() 方 法 获取 街道 信息 ,然后 将 
其 显示 在 对 应 的 TextView 上 。 

在 实际 项 目 开发 中 ,必须 学 会 复 用 示例 程序 中 的 相关 模块 的 代码 。GenerateLocationActivity 
类 中 关于 高 德 地 图 的 显示 以 及 定位 功能 的 实现 都 是 参照 示例 程序 中 的 代码 ,加 入 QR 
where 特定 的 业务 逻辑 。 在 阅读 理解 GenerateLocationActivity 类 的 源码 时 ,需要 结合 示例 
程序 相关 模块 的 代码 ,以 此 学 会 复 用 示例 代码 的 方法 。 

需要 强调 的 是 ,为 了 使 用 高 德 地 图 ,需要 登录 其 开放 平台 ,然后 单 击 页 面 右 上 角 的 控制 
人 台 , 进 入 “我 的 key” 页 面 ,该 页 面 列 出 了 登录 账号 所 申请 过 的 key 以 及 key 对 应 的 应 用 名 
称 。 单 击 页 面 中 的 “获取 key” 按 钮 ,填写 应 用 名 称 QR where, 选 择 绑 定 的 服务 平台 ,此 处 选 
TÉ" Android 平台 SDK”, 输 入 安全 码 SHA1 以 及 Package( 单 击 页 面 中 的 查看 Android 
SHAI1 5j Package 获取 方式 学 习 如 何 获取 这 两 个 参数 ) ,然后 单 击 “获取 key” 按 钮 即 可 完成 
申请 key。 

接着 ,需要 在 app/src/main 目录 下 的 AndroidMainfest. xml 配置 申请 的 key 和 相关 
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FUR : 


Caml versien-^1.0^ encoding- utf-8^7 
(asnifest xmins:sndreid- http://schemss android com/spk/res/sndroid" 
package-"application. test. zasp. com. myapplication" > 


Ó(uses-permission sndroid:name- sndroid permission INTERNET” /> 






(mses-permission zndroid:nzme-^sndroid permission WRITE EXTERNAL STORAGE” /> 
(nses-permission android:name-"smdroid permission ACCESS NETWORK STAIE" /> 权 限 

ses permission sndroid:nzsme-^sndroid permission ACCESS WIFI STATE” /> 
lleses-permission android:mame-^eadroid permission READ PHONE STATE” If 


(mses-permission android:name=" android. permission ACCESS COARSE LOCATION" /> 


Capplication 
sndroid:sllowBackup-"true^ 
sndroid:icon-^Bmipmsp/ic launcher” 
andreid:label-^My Application” 
android: theme- G5tyle/AppIhene^ > 
meta-data 


androi d-n: smsp spi v2 spikey^ 您 申请 的 key 





android:-value=" 请 输入 您 申请 的 key” /> 
cactivity 

android:name-" NainActivity” 

zndroid:lasbel-"My Applicstion" > 





程序 中 关于 返回 按钮 .生成 按钮 的 实现 以 及 跳 转 后 二 维 码 图 片 的 生成 页 面 , 皆 与 URL 
编辑 页 面 以 及 生成 URL. 二 维 码 图 片 的 页 面相 似 , 相 信 读 者 通过 阅读 源码 ,可 以 很 快 理解 ， 
此 处 不 再 著述 。 

单 击 GenerateorFragment 页 面 中 的 最 后 一 个 TableRow, 跳 转 到 WiFi 信息 编辑 页 面 ， 
此 页 面 的 实现 以 及 WiFi 二 维 码 图 片 的 生成 页 面 丝 与 第 一 个 TableRow 类 似 , 即 11. 5.1 节 
介绍 的 GenerateURLActivity 以 及 11. 5. 2 节 介 绍 的 UrlImageActivity . TE C ZR A fE 9435 . 
读者 可 通过 本 书 附带 源码 获得 这 部 分 的 实现 。 


(i1,6 开发 MapResultActivity 


在 11.4 节 所 介绍 的 HistoryFragment 界面 中 ,展示 了 存放 在 数据 库 中 的 数据 , 单 击 每 
个 列表 项 , 则 跳 转 到 对 应 的 详情 界面 中 ,当然 ,用 户 也 可 通过 底部 第 一 个 菜单 项 的 扫描 功能 
扫描 二 维 码 后 跳 转 到 相应 的 详情 界面 中 。 也 就 是 说 ,从 ScanFragment 以 及 HistoryFragment 
这 两 个 界面 中 同 种 类 型 所 跳 转 到 的 详情 页 面 是 一 样 的 。 

对 于 URL, WiFi 这 两 种 类 型 的 信息 来 说 ,所 跳 转 到 的 详情 页 面 都 是 将 文本 信息 显示 出 
来 ,并 且 显 示 了 文本 信息 所 对 应 的 二 维 码 图 片 , 唯 一 区 别 是 URL 详情 页 面 的 底部 提供 了 一 
个 Open in Browser 按钮 供用 户 在 手机 浏览 器 中 打开 URL 链接 。 这 两 种 类 型 对 应 的 详情 
页 面 都 与 11. 5. 2 节 所 介绍 的 URL 的 二 维 码 生 成 页 面 URLImageActivity 的 实现 类 似 , 此 
处 不 作 展开 介绍 。 

对 于 Contact 这 种 类 型 的 信息 来 说 , 跳 转 到 的 详情 页 面 则 同样 在 对 应 的 TextView 展示 
了 联系 人 信息 ,页面 中 提供 了 发 送 短 消息 以 及 拨打 电话 的 按钮 ,同时 还 提供 了 Create New 
Contact( 创 建新 联系 人 ) 以 及 Add to Existing Contact( 添 加 到 现 有 联系 人 ) 这 两 个 按钮 供用 
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户 根 据 所 传递 过 来 的 联系 人 信息 调用 联系 人 应 用 、 创 建新 联系 人 或 将 传递 过 来 的 联系 人 信 
息 添加 到 现 有 的 任意 联系 人 中 。 这 些 功能 的 实现 ,都 是 调用 普通 的 Android API 实现 的 ,并 
没有 任何 特殊 的 业务 逻辑 ,读者 可 以 通过 阅读 附带 源码 ,加 以 理解 体会 。 由 于 上 面 所 介绍 的 
功能 已 经 占据 了 界面 相当 大 的 一 部 分 , 故 在 同一 个 页 面 中 展示 二 维 码 图 片 显得 不 太 合理 , 故 
在 页 面 底部 提供 了 一 个 QRCode 按钮 供用 户 单 击 跳 转 到 二 维 码 图 片 显示 页 面 。 前 面 已 经 
介绍 过 二 维 码 图 片 的 生成 方法 了 ,故此 处 不 作 展 开 介绍 。 

需要 重点 介绍 的 是 扫描 包含 经 纬度 信息 的 二 维 码 图 片 或 从 历史 列表 中 单 击 Location 
类 型 的 列表 项 后 ,所 跳 转 到 的 详情 界面 MapResultActivity。 该 页 面 获取 上 级 页 面 中 所 传递 
过 来 的 数据 (包括 经 纬度 度数 ), 然 后 进行 逆 地 理 编码 , 即 根据 经 纬度 进行 地 图 定位 
(GenerateLocationActivity 是 根据 搜索 关键 字 进 行 地 图 定位 )。 这 部 分 功能 实现 是 通过 参 
照 示 例 程序 中 介绍 geocoder 地 理 编 码 功能 的 页 面 GeocoderActivity P J& TF 3i Hb FB gi 15 (1 
实现 代码 完成 的 。 读 者 在 理解 MapResultActivity 类 源码 的 同时 也 需要 参照 示例 程序 中 逆 
地 理 编码 部 分 的 源 代码 ,体会 复 用 源码 过 程 。MapResultActivity 类 源码 如 下 所 示 : 


package net. takewin. qrwhere. activity; 


import java. util. ArrayList; 
import java. util. List; 


import net. takewin. qrwhere. R; 

import net. takewin. qrwhere. entity. History; 
import net. takewin. qrwhere. util. AMapUtil; 
import net. takewin. qrwhere. util. CommonUtil; 
import android. app. Activity; 

import android. app. ProgressDialog; 

import android. content. Intent; 

import android. content. pm. PackageManager; 
import android. content. pm. ResolveInfo; 
import android. net. Uri; 

import android. os. Bundle; 

import android. view. View; 

import android. widget. Button; 

import android. widget. ImageView; 

import android. widget. TextView; 

import android. widget. Toast; 


import com. amap. api. maps2d. AMap; 

import com. amap. api. maps2d. AMap. InfoWindowAdapter; 

import com. amap. api. maps2d. CameraUpdateFactory; 

import com. amap. api. maps2d. MapView; 

import com. amap. api. maps2d. model. BitmapDescriptorFactory; 
import com. amap. api. maps2d. model. Marker; 

import com. amap. api. maps2d. model. MarkerOptions; 

import com. amap. api. services. core. LatLonPoint; 

import com. amap. api. services. geocoder. GeocodeResult; 
import com. amap. api. services. geocoder. GeocodeSearch; 
import com. amap. api. services. geocoder. GeocodeSearch. OnGeocodeSearchListener; 
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import com. amap. api. services. geocoder. RegeocodeQuery; 
import com. amap. api. services. geocoder. RegeocodeResult; 


public class  MapResultActivity extends Activity implements  OnGeocodeSearchListener, 
InfoWindowAdapter ( 
// 声 明 布 局 中 的 组 件 
private TextView title, topAddress, topPoint, buttomLat, buttomLon, buttomCity, buttomAdd; 
private String titleStr, latStr, lonStr, qStr, contenti; 
private ImageView back; 
private Button openMap, openQr; 


// 高 德 地 图 相关 

private ProgressDialog progDialog = null; 
private GeocodeSearch geocoderSearch; 
private String cityName, addressName; 
private AMap aMap; 

private MapView mapView; 

private LatLonPoint latLonPoint; 

private Marker regeoMarker; 


(QOverride 

protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
setContentView(R.layout.activity map result); 
mapView = (MapView) findViewById(R. id. map); 
mapView. onCreate(savedInstanceState); // 此 方法 必须 重 写 
initView(); 


(QOverride 

protected void onResume() ( 
super. onResune( ) ; 
mapView. onResume( ) ; 


(QOverride 

protected void onPause() { 
super. onPause( ) ; 
mapView. onPause() ; 


(ZOverride 

protected void onSaveInstanceState(Bundle outState) { 
super. onSaveInstanceState(outState); 
mapView. onSaveInstanceState(outState); 


[s 
* 显示 进度 条 对 话 框 
x/ 
public void showDialog() ( 


第 11 章 ”二 维 码 应 用 一 一 QR where fav) 


progDialog. setProgressStyle(ProgressDialog. STYLE SPINNER); 
progDialog. setIndeterminate(false); 
progDialog. setCancelable(true); 
progDialog. setMessage( "正在 获取 地 址 "); 
progDialog. show( ); 
) 


/ xx 
x 隐藏 进 度 条 对 话 框 
*/ 
public void dismissDialog() { 
if (progDialog != null) { 
progDialog.dismiss(); 
) 
) 


/ xx 
* 响应 逆 地 理 编码 
*/ 
public void getAddress(final LatLonPoint latLonPoint) { 
showDialog(); 
// 第 一 个 参数 表示 一 个 Lat1ng, 第 二 个 参数 表示 范围 多 少 米 , 第 三 个 参数 表示 是 火 系 坐标 
系 还 是 GPS 原生 坐标 系 
RegeocodeQuery query = new RegeocodeQuery(latLonPoint, 200, GeocodeSearch. AMAP); 
// 设 置 同步 逆 地 理 编码 请 求 
geocoderSearch. getFromLocationAsyn( query); 
) 


/ xx 
* 加 载 布局 中 的 各 个 View 并 初始 化 
*/ 
Private void initView() { 
initBack(); // 返 回 按钮 
Intent intent = getIntent(); 
titleStr = intent.getStringExtra("title"); 
latStr - intent.getStringExtra("lat"); 
lonStr - intent.getStringExtra("lon"); 
if (intent.getStringExtra("q") != null && ! intent.getStringExtra("q"). equals("")) ( 
// 地 图 缩放 比例 


qStr = intent.getStringExtra("q"); 
) eise ( 
qStr = ""; 


} 
// 根 据 获取 的 纬度 以 及 经 度 , 生成 LatLonPoint 对 象 , 供 逆 地 理 编码 以 及 逆 地 理 编码 回调 使 用 
latLonPoint = new LatLonPoint(Double. valueOf(latStr), Double. valueOf(lonStr)); 


initTitleText(); // 页 面 顶 部 标题 TextView 
initTopText (); // 悬 浮 在 地 图 上 面 TextView, 该 TextView 所 在 的 最 外 层 容器 LinearLayout 透明 
initButtomText(); // 地 图 下 方 的 各 个 TextView 
initMap(); // 初 始 化 地 图 
initOpenMap(); // 在 浏览 器 或 谷歌 地 图 APP 中 打开 页 面 中 的 地 图 


initOpenQr(); // 跳 转 页 面 显示 二 维 码 图 片 
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getAddress(latLonPoint); / / Ui pig f Jl FR Ai 
contentl = intent.getStringExtra("contentl"); 
if (intent.getStringExtra("flag").equals("scan")) ( 
// 如 果 是 从 ScanFragnent 界面 中 跳 转 过 来 的 


handleDB(); // 插 入 一 条 新 数据 
} 
} 
/ xx 
* 调用 API, 在 手机 浏览 器 打开 谷歌 地 图 显示 页 面 中 的 地 理 位 置 
*/ 


private void initOpenMap() ( 
openMap = (Button) this.findViewById(R. id. button open map); 
openMap. setOnClickListener(new View. OnClickListener() { 
(QOverride 
public void onClick(View v) { 
String mapAdd = "http://ditu. google. cn/maps? hl = zh&mrt = loc&q =" + 
latStr * "," * lonStr; 
Intent intent = new Intent(Intent. ACTION VIEW, Uri.parse(mapAdd)); 
intent. addFlags(Intent. FLAG ACTIVITY NEW TASK & Intent. FLAG ACTIVITY 
EXCLUDE FROM RECENTS); 
intent. setClassName( "com. google. android. apps. maps", "com. google. android. 
maps. MapsActivity"); 
if (isIntenthvailable(intent)) { 
startActivity(intent); 
return; 
) 
intent = new Intent(Intent. ACTION VIEW, Uri. parse(mapAdd)); 


startActivity(intent); 
) 
Di 
) 
/ xx 
* 跳 转 页 面 ,显示 二 维 码 图 片 
*/ 


private void initOpenQr() ( 
openQr = (Button) this. findViewById(R. id. button open qr); 
openQr. setOnClickListener(new View.OnClickListener() { 
(2 Override 
public void onClick(View v) { 
Intent intent - new Intent(MapResultActivity.this, QrMapResultActivity. class); 
Bundle bundle - new Bundle(); 
bundle. putString("title", titleStr); 
bundle. putString("contentl", contenti); 
intent. putExtras(bundle); 
startActivity(intent); 
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/ xx 
* 返回 按钮 
*/ 
private void initBack() { 
back = (ImageView) this.findViewById(R. id.back map result); 
back. setOnClickListener(new View.OnClickListener() { 
(QOverride 
public void onClick(View v) { 
MapResultActivity.this.finish(); 


) 
np; 
) 
/x¥ 
* 获取 上 级 页 面 中 传递 过 来 的 数据 项 显示 在 顶部 标题 TextView 中 
x*/ 


Private void initTitleText() { 
title = (TextView) this. findViewById(R. id. title map result TextView); 
title.setText(titleStr); 


/ xx 
* 悬浮 在 地 图 上 方 的 TextView 
*/ 
Private void initTopText() { 
topPoint = (TextView) this. findViewById(R. id.top point map); 
topPoint. setText(latStr + "," + lonStr); 
topAddress = (TextView) this.findViewById(R. id.top address map); 


/ xx 
* 在 地 图 下 面 的 各 个 TextView 
x/ 
private void initButtomText() { 
buttomLat = (TextView) this.findViewById(R. id.buttom lat textview); // 纬 度 
buttomLon = (TextView) this.findViewById(R. id.buttom lon textview); // 经 度 
buttomCity = (TextView) this. findViewById(R. id.buttom city textview); 

// 经 纬度 对 应 所 在 城市 
buttomAdd = (TextView) this. findViewById(R. id.buttom add textview); // 街 道 信息 
buttomLat.setText("Latitiude:" + latStr); 
buttomLon. setText("Longtitiude:" + lonStr); 


"m 
* 初始 化 地 图 实例 
*/ 
private void initMap() ( 
if (aMap == null) { 
aMap = mapView.getMap(); 
regeoMarker = aMap. addMarker (new MarkerOptions( ). anchor (0. 5f, 0. 5f). icon 
(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE RED))); 
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} 

geocoderSearch = new GeocodeSearch(this); 
geocoderSearch. setOnGeocodeSearchListener(this); 
progDialog = new ProgressDialog(this); 


"m 
* 操作 数据 库 ,插入 数据 
*/ 
private void handleDB() { 
ArrayList «History» histories = new ArrayList «History»(); 
String createTime = CommonUtil.getTime(); 
History history = new History(createTime, titleStr, contentl, "", "scan", "location"); 
histories. add(history); 
MainActivity. dbManager. add(histories); 


(QOverride 
public void onGeocodeSearched(GeocodeResult result, int rCode) { 
) 


/ xx 
* 道 地 理 编码 回调 
*/ 
(QOverride 
public void onRegeocodeSearched(RegeocodeResult result, int rCode) ( 
dismissDialog(); 
if (rCode == 0) { 
if (result !- null && result. getRegeocodeAddress () != null && result. 
getRegeocodeAddress().getFormatAddress() != null) { 
cityName = result.getRegeocodeAddress().getCity(); 
addressName = result.getRegeocodeAddress().getFormatAddress(); 
if (!qStr.equals("")) ( 
aMap. animateCamera(CameraUpdateFactory. newLatLngZoom(AMapUtil. 
convertToLatLng(latLonPoint), Float.valueOf(qStr))); 
) else ( 
aMap. animateCamera(CameraUpdateFactory. newLatLngZoom( AMapUtil. 
convertToLatLng(latLonPoint), Float. valueOf(15))); 
) 
regeoMarker. setPosition(AMapUtil. convertToLatLng(latLonPoint)); 
regeoMarker. setTitle(result.getRegeocodeAddress().getCity()); 
regeoMarker. setDraggable(true); 
regeoMarker. showInfoWindow(); 
topAddress. setText(cityName); 
buttonCity. setText(cityName); 
buttomAdd. setText(addressName); 
} eise ( 
Toast. makeText (MapResultActivity. this, "对 不 起 ,没有 搜索 到 相关 数据 !"， 
3000). show() ; 
) 
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) else if (rCode == 27) { 


Toast.makeText (MapResultActivity. this, "搜索 失败 ,请 检查 网 络 连接 !"，3000). show() ; 
) else if (rCode == 32) { 

Toast.makeText(MapResultActivity.this, "key 验证 无 效 !"，3000). show() ; 
} eise ( 

Toast. nakeText (MapResultActivity. this, "未 知 错误 ,请 稍 后 重 试 ! 错误 码 为 "， 
3000). show() ; 
) 
) 


(QOverride 
public View getInfoContents(Marker arg0) ( 
return null; 


) 


(QOverride 
public View getInfoWindow(Marker marker) ( 
// 地 图 标记 上 的 扩展 信息 
View view = getLayoutInflater(). inflate(R. layout. poikeywordsearch uri result, null); 
TextView title = (TextView) view. findViewById(R. id. title result); 
title.setText(marker.getTitle()); 
TextView snippet - (TextView) view.findViewById(R. id. snippet result); 
snippet. setText(marker.getSnippet()); 
return view; 


) 


private boolean isIntentAvailable(Intent intent) { 
List«ResolveInfo» activities = getPackageManager().queryIntentActivities( intent, 
PackageManager. COMPONENT ENABLED STATE DEFAULT); 
return activities.size() !- 0; 


) 


代码 文件 : codes\11\QR where\cn\edu\hstc\qrwhere\activity\MapResultActivity. java 


(1.7 开发 第 四 个 菜单 项 所 对 应 的 界面 SettingFragment 


SettingFragment 对 应 第 四 个 菜单 项 的 界面 。Setting 的 中 文 含义 为 设置 。 该 界面 提供 
了 两 个 可 单 击 的 列表 项 : About 和 Clear History。 单 击 About. 弹出 一 个 对 话 框 , 显示 
“Made In HSTC"; 单 击 Clear History, 弹 出 一 个 询问 对 话 框 , 询 问 “Are you sure?”。 若 用 
户 单 击 Confirm, 则 调用 操作 数据 库 的 工具 类 清空 作 清 空 数据 库 表 操作 ; 若 用 户 单 击 
Cancel, 则 取消 对 话 框 。SettingFragment 所 对 应 的 界面 布局 如 下 : 





< LinearLayout xmlns:android = "http://schemas. android. con/apk/res/android" 
android:layout width= "match parent" 
android:layout height = "match parent" 
android:background = "(Z color/white" 
android:orientation = "vertical" > 
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<! -- 顶部 标题 --> 

< RelativeLayout 
android:layout width= "fill parent" 
android:layout height = "wrap content" 
android:background = "(2 color/backhost" 
android:padding = "10dip" > 


« TextView 
android:id- "(9 * id/titleTextView" 
android:layout width = "wrap content" 
android:layout height = "wrap content" 
android:layout centerHorizontal = "true" 
android:layout centerVertical = "true" 
android:paddingTop - "10dp" 
android:paddingBottom = "10dp" 
android:text = "(2string/setting" 
android:textColor = "(Qcolor/white" 

"20sp" /» 





android:textSize- 
«/RelativeLayout > 


< RelativeLayout 
android:layout width = "fill parent" 
android:layout height = "wrap content" » 


< LinearLayout 
android: id = "(à + id/linearlayout top" 
android:layout width- "fill parent" 
android:layout height = "40dp" 
android:orientation = "vertical" /» 


< TextView 
android:id- "(à + id/textview top" 
android:layout width- "fill parent" 
android:background = "(2 color/gainsboro" 
android:layout height = "0. 5dip" 
android: layout_below = "@ id/linearlayout_top" /> 


< ListView 
android: id="@ + id/listview setting" 
android:layout width- "fill parent" 
android:layout height = "wrap content" 
android:divider = "(2 color/gainsboro" 
android:dividerHeight = "0. 5dip" 
android: layout_below = "@ id/textview_top" /> 


< TextView 
android:id- "(à + id/textview_buttom" 
android:layout width- "fill parent" 
android:background = "(2 color/gainsboro" 
android:layout height = "0. 5dip" 
android:layout below- "(Jid/listview setting" /> 
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</RelativeLayout > 


</LinearLayout > 
代码 文件 : codes\11\QR where\res\layout\activity_setting. xml 


上 面 布局 中 放置 的 ListView 正 是 为 了 在 界面 中 显示 About 列表 项 以 及 Clear History 
列表 项 。 
界面 Java 程序 SettingFragment 类 实现 如 下 : 


package net. takewin. qrwhere. fragment; 


import java. util. ArrayList; 
import java.util.List; 


import net. takewin. qrwhere. R; 

import net. takewin. qrwhere. util. MySettingListViewAdapter; 
import net. takewin. qrwhere. view. MyAboutDialog; 

import net. takewin. qrwhere. view. MyDialog; 

import android. app.Dialog; 

import android. os. Bundle; 

import android. support. v4. app. Fragment; 

import android. view. LayoutInflater; 

import android. view. View; 

import android. view. ViewGroup; 

import android. widget. AdapterView; 

import android. widget. AdapterView. OnItemClickListener; 
import android. widget. ListView; 


public class SettingFragnent extends Fragment ( 
private ListView settingListView; 


(QOverride 
public View onCreateView ( LayoutInflater  inflater, ViewGroup container, Bundle 
savedInstanceState) ( 
return inflater. inflate(R.layout.activity setting, null); 


(QOverride 

public void onActivityCreated(Bundle savedInstanceState) ( 
super. onActivityCreated(savedInstanceState); 
initSettingListView(); 


private void initSettingListView() { 
List«String» listStrings = new ArrayList «String»(); 
listStrings. add(" About") ; HRF 
listStrings.add("Clear History");  // 清 空 数据 库 
// 获 取 界 面 布局 中 的 ListView 组 件 
settingListView = (ListView) getActivity().findViewById(R. id. listview setting); 
// 设 置 适 配器 
settingListView. setAdapter ( new MySettingListViewAdapter ( getActivity ( ), 
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listStrings)); 
settingListView. setOnItemClickListener(new OnItemClickListener() { 
// 列 表 项 单 击 事件 
@Override 
public void onItemClick(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
if (arg2 == 0) { // 弹 出 关于 的 自 定义 对 话 框 
Dialog dialog = new MyAboutDialog(getActivity(), R. style. MyAboutDialog); 
dialog. show(); 
} else if (arg? == 1) { // 弹 出 询问 是 否 清空 数据 库 的 自 定义 对 话 框 
// 在 对 话 框 实现 类 MyDialog 中 操作 数据 库 , 清空 表 
Dialog dialog = new MyDialog(getActivity(), R.style.MyDialog); 
dialog. show(); 
} 
} 
Di 
) 
} 


代码 文件 : codes\11\QR where\cn\edu\hstc\qrwhere\fragment\SettingFragment. java 


上 面 程序 中 实现 单 击 界面 中 的 About, 弹 出 一 个 自 定 以 显示 对 话 框 ,该 对 话 框 中 显示 了 
提示 消息 “Made In HSTC”。 从 上 面 的 Java 程序 上 看 ,该 自 定义 对 话 框 是 通过 创建 一 个 
Dialog 子 类 对 象 ,然后 调用 其 show() 方 法 实现 的 。 如 下 代码 片段 : 


Dialog dialog = new MyAboutDialog(getActivity(), R. style. MyAboutDialog); 
dialog. show(); 


因此 ,我 们 需要 知道 MyAboutDialog 类 的 实现 : 


package net. takewin. qrwhere. view; 


import net. takewin. qrwhere. R; 
import android. app. Dialog; 
import android. content. Context; 
import android. os. Bundle; 
import android. view. View; 
import android. widget. TextView; 


public class MyAboutDialog extends Dialog { 
Context context; 
Private TextView ok; 


public MyAboutDialog(Context context) { 
super(context); 
this.context = context; 


) 


public MyAboutDialog(Context context, int theme) { 
super(context, theme); 
this.context = context; 
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(QOverride 


protected void onCreate(Bundle savedInstanceState) { 
super. onCreate(savedInstanceState); 
// 加 载 对 话 框 布局 
this. setContentView(R. layout.dialog about); 
// 获 取 对 话 框 中 的 Ok 按钮 
ok = (TextView) findViewById(R. id. ok) ; 
// 设 置 单 击 事件 监听 器 
ok. setOnClickListener(new View. OnClickListener() { 
(QOverride 
public void onClick(View v) { 
// 取 消 对 话 框 
MyAboutDialog. this.dismiss(); 


H); 


代码 文件 : codes\11\QR where\cn\edu\hstc\qrwhere\view\MyAboutDialog. java 


上 面 Java 类 继承 自 android. app. Dialog, 重 写 onCreate 方法 ,实现 自 定义 一 个 对 话 框 
组 件 。 在 onCreate 方法 中 ,程序 加 载 该 自 定义 对 话 框 的 界面 布局 ,获取 布局 中 的 按钮 (此 处 
为 一 个 TextVeiw) ,然后 为 其 添加 单 击 事件 监听 器 。 该 布局 定义 了 对 话 框 的 样式 ,提示 请 
Made In HSTC 即 是 通过 该 布局 实现 。 以 下 为 自 定 义 对 话 框 对 应 的 布局 代码 : 


<?xml version = "1.0" encoding = "utf 一 8"?> 

<LinearLayout xmlns:android = "http://schemas. android. com/apk/res/android" 
android:layout width = "260dp" 
android:layout height = "match parent" 
android:background = "(Zdrawable/segmented selected bg" 
android:orientation = "vertical" > 


< TextView 
android:layout width = "fill parent" 
android:layout height - "60dp" 
android:text = "Made In HSTC. " 
android:textSize = "16sp" 
android:textColor = "@color/black" 
android:gravity = "center vertical|center horizontal"/» 


« TextView 
android:layout width- "fill parent" 
android:layout height = "0.5dip" 
android:background = "(Z2 color/lightgray" /> 


« TextView 
android:id- "(2 + id/ok" 
android:layout width- "fill parent" 
android:layout height = "40dp" 
android:text = "Ok" 
android:textColor = " # 0066FF" 
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android:textSize = "20sp" 
android:gravity = "center vertical|center horizontal" /> 


«/LinearLayout > 
代码 文件 : codes\11\QR where\res\layout\dialog about. xml 

实际 上 ,QR where 中 所 有 需要 用 到 弹出 对 话 框 的 地 方 ,都 是 通过 自 定义 对 话 框 布局 ， 
然后 自 定义 对 话 框 组 件 加 载 该 布局 ,接着 在 对 应 的 程序 中 创建 该 对 话 框 的 实例 ,调用 showO 
方法 来 实现 的 。 包 括 单 击 SettingFragment 界面 中 的 第 二 个 列表 项 Clear History 所 弹出 的 
对 话 框 亦 是 通过 上 述 方式 实现 的 。 只 不 过 在 其 对 话 框 布局 中 放置 的 是 两 个 按钮 (此 处 为 两 
个 TextView) : 一 个 是 Cancel, 另 一 个 则 是 Confirm ,然后 依次 为 这 两 个 按钮 添加 单 击 事件 
监听 器 。 为 Cancel 添加 的 监听 器 实现 取消 对 话 框 ,为 Confirm 添加 的 监听 器 实现 调用 数据 
库 操作 工具 类 DBManager 的 对 象 MainActivity. dbManager 的 deleteTheTable (String 
tableName) 方 法 清空 history 表 数 据 。 由 于 实现 原理 以 及 过 程 相 同 , 此 处 不 再 歼 述 ,读者 可 
以 通过 附带 源码 获得 实现 代码 。 


(i1,8 OR where 运行 效果 图 


前 面 已 经 将 QR where 的 开发 流程 全 部 介绍 完毕 ,当然 ,读者 还 是 需要 通过 本 书 附带 源 
码 加 深 学 习 理 解 , 部 分 工具 类 ,二 维 码 解析 与 生成 .ShareSDK 、 高 德 地 图 等 功能 的 实现 ,都 是 
可 以 在 其 他 Android 项 目 中 进行 复 用 的 ,所 以 希望 读者 能 对 QR where 的 实现 源码 加 以 阅 
读 体会 。 

为 了 读者 更 好 地 体会 QR where 的 功能 ,下 面 将 部 分 运行 效果 的 截图 贴 出 ,如 下 所 示 : 

D 打开 软件 ,启动 界面 MainActivity 默认 打开 底部 第 一 个 菜单 项 ,如 图 11. 1 所 示 。 

© 此 时 , 单 击 右上 角 的 按钮 可 打开 或 关闭 手机 自 带 闪 关 灯 功 能 ; 打开 左上 角 按 钮 , 则 
调用 系统 相册 ,选中 任意 一 张 图 片 ,返回 QR where 应 用 ,解析 返回 的 图 片 , 若 该 图 片 中 不 包 
含 二 维 码 矩 阵 图 , 则 会 弹出 一 个 对 话 框 提示 用 户 , 如 图 11. 2 所 示 。 

© 若 此 时 返回 的 图 片 中 包含 二 维 码 和 矩阵 图 , 则 根据 解析 结果 ,判断 对 应 的 结果 类 型 , 跳 
转 到 相应 的 界面 中 ,对 于 URL、WiFi、 其 他 普通 文本 类 型 则 跳 转 到 如 图 11. 3 所 示 的 页 面 中 
(这 几 种 类 型 的 二 维 码 显示 页 面相 类 似 ,这 里 以 WiFi 类 型 为 例 ) 。 

@ 若 返 回 的 图 片 中 所 包含 的 二 维 码 信息 为 Contact 类 型 , 则 解析 后 跳 转 到 的 页 面 如 
图 11.4 所 示 。 

© 单 击 图 11. 4 中 手机 号 码 右边 的 发 送 短信 图 标 或 拨打 电话 图 标 即 可 调用 相应 的 系统 
应 用 ,发送 短 信 或 拨 出 电话 ; 单 击 页 面 中 的 Send Message, 则 打开 手机 邮件 应 用 发 送 邮件 ; 
单 击 页 面 中 的 最 后 一 项 QRCode, 则 跳 转 到 显示 联系 人 二 维 码 图 片 的 页 面 ; 若 单 击 页 面 中 
的 Create New Contact, 则 调用 联系 人 应 用 的 新 增 联系 人 模块 并 将 页 面 中 的 联系 人 信息 自 
动 传递 到 联系 人 新 增 页 面 ,如 图 11. 5 所 示 。 

© 单 击 如 图 11.4 所 示 页 面 中 的 Add to Existing Contact, 则 打开 现 有 联系 人 列表 , 选 
中 任意 一 个 联系 人 (假如 选择 联系 人 列表 中 的 “小 红 ”) , 跳 转 到 该 联系 人 修改 页 面 ,并 将 页 面 
中 的 联系 人 信息 传递 至 该 页 面 中 ,如 图 11.6 所 示 。 





图 11.1 Scan 界面 


(e wifi:S:test;P:123456;... 





WIFI:S:test;P:123456; :WPA/WPA2;; 


ID:t 





图 11.3 解析 二 维 码 (URL、WiFi、 其 他 普通 文本 ) 


后 跳 转 到 的 页 面 
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No barcode detected 


Ok 


图 11.2 提示 未 检测 到 条 形 码 
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图 11.4 解析 二 维 码 (Contact 类 型 ) 
后 跳 转 的 页 面 
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vor E v. or 3 
手机 联系 人 LI 手机 联系 人 LJ 
小 明 ~ 小 红 ~ 
A P 
百度 百度 
职位 职位 
电话 电话 
13421082933 手机 X 13421082955 手机 
" á n A 
添加 新 条 目 13421082933 手机 
n d 
SINE 添加 新 条 目 
12345678@qq.com 家 用 x 电子 邮件 
添加 新 条 目 12345678@qq.com 家 用 
n d 
fiie 添加 新 条 目 
街道 2 
1L5 新 增 联系 人 图 11.6 添加 至 现 有 联系 人 


CD 若 单 击 Scan 页 面 左上 角 按 钮 返回 的 图 片 中 的 二 维 码 和 矩阵 信息 为 Location 类 型 , 则 
解析 后 跳 转 到 的 页 面 如 图 11.7 所 示 。 

@@ 单 击 Scan 页 面 左 上 角 的 图 标 , 进 入 手机 相册 ,选中 一 张 图 片 , 自 动 返回 Scan 页 面 并 
开始 解析 图 片 中 的 二 维 码 ,解析 成 功 后 进行 页 面 跳 转 。 由 于 这 种 操作 实现 的 页 面 跳 转 与 直 
接 使 用 扫描 框 扫描 二 维 码 图 片 后 的 页 面 跳 转 相同 ,故此 处 不 演示 扫描 框 扫描 二 维 码 后 的 跳 
转 过 程 。 单 击 启动 界面 底部 第 二 个 菜单 项 ,可 以 看 到 如 图 11. 8 所 示 的 运行 效果 图 。 

© 单 击 图 11. 8 中 的 Tab 页 Generate, 可 以 看 到 如 图 11. 9 所 示 的 运行 效果 图 。 

O 单 击 History 列表 页 面 中 的 列表 项 , 则 根据 类 型 跳 转 到 对 应 的 页 面 , 这 部 分 的 跳 转 
与 解析 二 维 码 图 片 后 的 跳 转 页 面 类 似 , 唯 一 的 区 别 在 于 从 历史 列表 跳 转 过 去 时 ,不 再 对 
history 表 执 行 插入 新 数据 的 操作 。 

D 单 击 启动 界面 底部 第 三 个 菜单 项 ,可 以 看 到 如 图 11. 10 所 示 运 行 效果 图 。 

O 单 击 如 图 11. 10 所 示 界 面 中 的 各 个 TabRow, 跳 转 到 相应 的 信息 编辑 页 面 ,并 填写 
相应 的 信息 , 单 击 第 一 行 , 跳 转 到 URL 信息 编辑 页 面 ,如 图 11. 11 所 示 。 

B 单 击 图 11. 11 中 的 Generate 按钮 , 跳 转 到 下 级 页 面 , 生 成 二 维 码 并 显示 ,操作 数据 库 
插入 新 数据 ,如 图 11. 12 所 示 。 
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图 11.7 解析 二 维 码 (Location 类 型 ) 后 的 跳 转 页 面 图 11.8 Scan 历史 列表 页 面 











Generate 
9 Geo:23.671408,116.... 
*v wifi:S:rrr;P:ttttttt; T-W. 
œ http://urlhk.co/3za Contact 
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Location 
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ED S: 





图 11.9 Generate 历史 列表 页 面 图 11.10 GeneratorFragment 界面 
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OR/ Short URL http://urlhk.co/3xG 





http://www.baidu.com E] 


GiT xx. zm Q | 加 
， [n]: 7». 


http://urlhk.co/3xG 


v [n] 


a s d ro hj KI 


4 z xc v b nm a 


123 ES ab 一 : 符 «e 
图 11.11 编辑 URL 信息 图 11.12 生成 URL 二 维 码 


O 单 击 图 11. 10 中 的 第 二 行 , 跳 转 到 联系 人 信息 编辑 页 面 ,编辑 相应 的 信息 ,如 图 11. 13 
所 示 。 

O 单 击 图 1. 13 页 面 右 上 角 的 按钮 , 调 出 手机 联系 人 应 用 ,选中 任意 联系 人 ,获取 该 联 
系 人 信息 并 返回 页 面 , 将 对 应 信息 填充 到 对 应 的 编辑 框 中 。 

© 单 击 图 1.13 页 面 中 的 Generate 按钮 , 跳 转 到 生成 联系 人 二 维 码 页 面 ,如 图 11. 14 所 示 。 

O 单 击 图 11. 10 中 的 第 三 行 , 跳 转 到 坐标 拾取 页 面 ,如 图 11. 15 所 示 。 

B 在 坐标 拾取 页 面 中 的 关键 字 输 入 框 中 输入 关键 字 , 如 图 11. 16 所 示 。 

O 选中 “潮州 西湖 ”, 单 击 搜索 按钮 进行 搜索 定位 ,可 以 看 到 如 图 11. 17 所 示 的 效果 图 。 

D 单 击 页 面 中 的 Generate 按钮 , 跳 转 到 生成 经 纬度 信息 二 维 码 的 页 面 ,如 图 11. 18 
所 示 。 

€» 单 击 图 11. 10 页 面 中 的 第 四 行 , 跳 转 到 WiFi 信息 编辑 页 面 ,如 图 11. 19 所 示 。 

四 在 任意 显示 二 维 码 图 片 的 页 面 中 , 单 击 页 面 右上 角 按钮 ,都 会 在 页 面 底部 弹出 一 个 
选择 框 ,如 图 11. 20 所 示 。 

B 单 击 选择 框 中 的 Share to 按钮 , 则 调用 Share 模块 ,弹出 集成 了 各 大 社交 平台 的 选 
择 框 ,如 图 11.21 所 示 。 

O 选择 图 11. 21 中 的 任意 图 标 , 则 可 一 键 分 享 至 该 平台 ,这 里 以 分 享 至 微 博 为 例 , 单 击 
新 浪 微 博 的 图 标 , 弹 出 对 话 框 ,如 图 11. 22 所 示 。 

四 单 击 启动 界面 底部 第 四 个 菜单 项 , 跳 转 到 设置 页 面 , 单 击 页 面 中 的 Clear History, 弹 
出 确认 对 话 框 ,可 以 看 到 如 图 11. 23 所 示 效 果 图 。 
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图 11.13 联系 人 信息 编辑 页 面 
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图 11.15 坐标 拾取 页 面 
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VERSION:3.0 
FN: 小 明 
TEL:13421082933 
EMAIL:12345678@qq.com 
ORO: 百度 





图 11.14 生成 Contact 二 维 码 
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E 11.16 输入 poi 关键 字 


(se Android 应 用 开发 从 入 门 到 精通 
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图 11.17 高 德 地 图 搜索 结果 页 面 图 11.18 生成 Location 二 维 码 
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Password tttttt 


Network Type WPA/WPA2 


BEGIN: VCARD 
VERSION:3.0 
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o encryp 


图 11.19 生成 WiFi 二 维 码 图 11. 20 “分享 模块 
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联系 人 信息 : 小 明 
13421082933 
12345678@qq.com 百度 . 
分 享 来 自 QR where, FFH ” 


接 http://www.hstc.edu.cn 
@ 新 浪 微 博 的 朋友 








图 11.21 弹出 集成 分 享 平 台 选 择 框 图 11.22 分 享 至 微 博 平 台 


Are you sure? 


Cancel Confirm 





图 11.23 是 否 清空 数据 表 的 提示 


(ò Android 应 用 开发 从 入 门 到 精通 


€) 单 击 Confirm 按钮 , 则 将 QR where 的 数据 库 表 history 清空 ,此 时 再 返回 
HistoryFragment, 则 已 经 看 不 到 任何 历史 数据 了 。 


(1.9 本 章 小 结 


本 章 介绍 了 一 款 基 于 Android 系统 的 二 维 码 应 用 QR where, 该 应 用 使 用 了 ZXing 框 
架 以 及 ZBar 框架 解析 和 生成 二 维 码 ,大 量 调用 Android API 操作 系统 相册 、 手 机 联系 人 应 
用 ,项 目 中 还 集成 了 一 键 分 享 平台 ShareSDK ,使 用 高 德 地 图 进行 地 图 显示 以 及 定位 , 除 此 
之 外 ,项 目 还 涉及 Android 自 带 的 数据 库 SQLite 的 操作 。 通 过 该 应 用 的 实现 ,读者 可 以 了 
解 一 些 前 面 章节 没有 涉及 的 优秀 的 第 三 方 产品 ,对 项 目 中 的 工具 类 ,底部 选择 框 等 实现 源 
码 , 读 者 应 该 学 会 对 其 进行 复 用 。 


a] 
[2] 
[3] 
[4] 
[5] 
[e] 
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提供 配套 的 资源 ,有 需求 的 读者 请 扫描 下 方 的 “ 书 圈 " 微 信 公 众 号 二 维 码 , 在 图 
书 专区 下 载 ,也 可 以 拨打 电话 或 发 送 电子 邮件 咨询 。 

如 果 您 在 使 用 本 书 的 过 程 中 遇 到 了 什么 问题 ,或 者 有 相关 图 书 出 版 计划 ， 
也 请 您 发 邮件 告诉 我 们 ,以 便 我 们 更 好 地 为 您 服务 



















































































我 们 的 联系 方式 : 
地 dk: 北京 海淀 区 双 清 路 学 研 大 厦 A Æ 707 


资源 Nis funi 申请 


邮 编 : 100084 
电 话 : 010— 62770175 — 4604 


资源 下 载 : http://www. tup. com. cn 





电子 邮件 : weijj tup. tsinghua. edu. cn 
QQ: 883604( 请 写 明 您 的 单位 和 姓名 ) 
用 微 信 扫 一 扫 右 边 的 二 维 码 , 即 可 关注 清华 大 学 出 版 社 公 众 号 “ 书 圈 ”。 


